{"source":"doffin","operation":"search_doffin","description":"Search Norwegian public procurement notices on Doffin. Signature: search_doffin(query: string, optional, default ''; types: list of string (comma-separated), optional, default None; statuses: list of string (comma-separated), optional, default None; contract_nature: list of string (comma-separated), optional, default None; cpv_codes: list of string (comma-separated), optional, default None; locations: list of string (comma-separated), optional, default None; buyer: list of string (comma-separated), optional, default None; winner: list of string (comma-separated), optional, default None; date_from: string, optional, default None; date_to: string, optional, default None; sort_by: string, optional, default 'RELEVANCE'; page: integer, optional, default 1; hits_per_page: integer, optional, default 10; include_placeholders: yes/no, optional, default False; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0).","signature":"search_doffin(query: string, optional, default ''; types: list of string (comma-separated), optional, default None; statuses: list of string (comma-separated), optional, default None; contract_nature: list of string (comma-separated), optional, default None; cpv_codes: list of string (comma-separated), optional, default None; locations: list of string (comma-separated), optional, default None; buyer: list of string (comma-separated), optional, default None; winner: list of string (comma-separated), optional, default None; date_from: string, optional, default None; date_to: string, optional, default None; sort_by: string, optional, default 'RELEVANCE'; page: integer, optional, default 1; hits_per_page: integer, optional, default 10; include_placeholders: yes/no, optional, default False; limit: integer, items, optional, default 25; offset: integer, items, optional, default 0)","parameters":[{"name":"query","type":"string","schema":{"type":"string"},"required":false,"default":"","description":"Free-text search (Norwegian or English), e.g. \"IT-drift\", \"sn\u00f8rydding\", \"rammeavtale konsulent\". Start here.","unit":null},{"name":"types","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"Filter by notice type. Parent types: PLANNING, COMPETITION, RESULT. Specific types: ANNOUNCEMENT_OF_COMPETITION, DYNAMIC_PURCHASING_SCHEME, QUALIFICATION_SCHEME, ANNOUNCEMENT_OF_INTENT, PRE_ANNOUNCEMENT, ADVISORY_NOTICE, NOTICE_ON_BUYER_PROFILE, ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT, CHANGE_OF_CONCLUSION_OF_CONTRACT, CANCELLED_OR_MISSING_CONCLUSION_OF_CONTRACT. Use [\"COMPETITION\"] + statuses=[\"ACTIVE\"] for open tenders.","unit":null},{"name":"statuses","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"ACTIVE (open for bids), EXPIRED, AWARDED, CANCELLED.","unit":null},{"name":"contract_nature","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"WORKS, SERVICES and/or SUPPLIES.","unit":null},{"name":"cpv_codes","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"8-digit CPV codes, e.g. [\"45000000\"]. Matches the code and its children. Find codes with search_cpv_codes(). Best combined with a free-text query.","unit":null},{"name":"locations","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"NUTS-style location ids, e.g. [\"NO060\"] (Tr\u00f8ndelag), or \"anyw\" for non-location-bound. See list_location_codes().","unit":null},{"name":"buyer","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"Buyer organization full name(s) exactly as written on notices, e.g. [\"Trondheim kommune\"]. Resolved to Doffin's internal buyer id via a free-text lookup; names that match no buyer are reported in \"note\" and, if none match, no results are returned (rather than an unfiltered search). Pass the 32-hex buyer id from a result's buyer field directly to skip the lookup.","unit":null},{"name":"winner","type":"array","schema":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}]},"required":false,"default":null,"description":"Doffin's internal supplier id (32-hex). Winner names cannot be used - they are not present in search results to resolve against.","unit":null},{"name":"date_from","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Publication date lower bound, \"YYYY-MM-DD\".","unit":null},{"name":"date_to","type":"string","schema":{"anyOf":[{"type":"string"},{"type":"null"}]},"required":false,"default":null,"description":"Publication date upper bound, \"YYYY-MM-DD\".","unit":null},{"name":"sort_by","type":"string","schema":{"type":"string"},"required":false,"default":"RELEVANCE","description":"RELEVANCE (default), PUBLICATION_DATE_DESC, PUBLICATION_DATE_ASC, DEADLINE, ESTIMATED_VALUE_ASC, ESTIMATED_VALUE_DESC.","unit":null},{"name":"page","type":"integer","schema":{"type":"integer"},"required":false,"default":1,"description":"1-based page number.","unit":null},{"name":"hits_per_page","type":"integer","schema":{"type":"integer"},"required":false,"default":10,"description":"1-50 (default 10).","unit":null},{"name":"include_placeholders","type":"boolean","schema":{"type":"boolean"},"required":false,"default":false,"description":"By default, hits whose buyer fields look like unfilled eForm template values (org id 123456789, placeholder buyer names) are dropped from the results as junk. Set True to keep them, each flagged with \"possible_placeholder\": true.","unit":null},{"name":"limit","type":"integer","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"display_type":"integer","required":false,"default":25,"description":"Maximum list items returned by the gateway (default 25, maximum 100).","unit":"items"},{"name":"offset","type":"integer","schema":{"type":"integer","minimum":0,"default":0},"display_type":"integer","required":false,"default":0,"description":"Number of list items to skip before returning the page.","unit":"items"}],"json_get_url_template":"https://allemannsdata.com/wiki/api/v1/kilder/doffin/search_doffin?query=&types={types}&statuses={statuses}&contract_nature={contract_nature}&cpv_codes={cpv_codes}&locations={locations}&buyer={buyer}&winner={winner}&date_from={date_from}&date_to={date_to}&sort_by=RELEVANCE&page=1&hits_per_page=10&include_placeholders=false&limit=25&offset=0","schema_scope":"#/data in the successful operation envelope","response_schema":{"type":"object","properties":{"total_count":{"type":["integer","null"]},"hits":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"heading":{"type":["string","null"]},"description":{"type":["string","null"]},"buyer":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["string","null"]},"organization_id":{"type":["string","null"]},"name":{"type":["string","null"]}}}},"type":{"type":["string","null"]},"allTypes":{"type":["array","null"],"items":{"type":"string"}},"status":{"type":["string","null"]},"issueDate":{"type":["string","null"],"format":"date-time"},"deadline":{"type":["string","null"],"format":"date-time"},"publicationDate":{"type":["string","null"],"format":"date"},"sentToTed":{"type":["boolean","null"]},"estimatedValue":{"type":["object","null"],"properties":{"currencyCode":{"type":["string","null"]},"amount":{"type":["number","null"]}}},"location_id":{"type":["array","null"],"items":{"type":"string"}},"placeOfPerformance":{"type":["array","null"],"items":{"type":"string"}},"possible_placeholder":{"type":"boolean"}},"required":["id"]}},"note":{"type":["string","null"]}},"additionalProperties":false,"required":["total_count","hits"]},"response_schema_status":{"status":"declared","codegen_safe":true,"description":"Maintained response contract."},"entity_projection":{"status":"projected","entity_types":["procurement","organization"],"description":"Recognized records and stable operation identifiers are projected; an empty array means the successful payload contained no recognizable entity."},"error_contract":{"scope":"top-level HTTP error response; never part of a success payload","schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}},"additionalProperties":false,"required":["code","message","retryable"]},"suggestion":{"type":"string"},"_meta":{"type":"object","properties":{"retrieved_at":{"type":"string","format":"date-time"},"language":{"type":"string","const":"en"},"content_languages":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"type":"object"}}},"required":["retrieved_at","language","content_languages","sources"]},"_links":{"type":"object","properties":{"self":{"type":"string","format":"uri"},"api_index":{"type":"string","format":"uri"},"feedback":{"type":"string","format":"uri"}},"required":["self","api_index","feedback"],"additionalProperties":false}},"additionalProperties":false,"required":["error","suggestion","_meta","_links"]},"statuses":{"400":{"codes":["MISSING_PARAMETER","INVALID_PARAMETER","INVALID_REQUEST"],"retryable":false},"404":{"codes":["SOURCE_NOT_FOUND","OPERATION_NOT_FOUND","ENTITY_NOT_FOUND"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"502":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":true}}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/doffin/search_doffin/schema","operation":"https://allemannsdata.com/wiki/api/v1/kilder/doffin/search_doffin","source":"https://allemannsdata.com/wiki/api/v1/kilder/doffin","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"},"output_fields":["total_count","hits","hits[].id","hits[].heading","hits[].description","hits[].buyer","hits[].buyer[].id","hits[].buyer[].organization_id","hits[].buyer[].name","hits[].type","hits[].allTypes","hits[].status","hits[].issueDate","hits[].deadline","hits[].publicationDate","hits[].sentToTed","hits[].estimatedValue","hits[].estimatedValue.currencyCode","hits[].estimatedValue.amount","hits[].location_id","hits[].placeOfPerformance","hits[].possible_placeholder","note"],"output_fields_truncated":false,"canonical_field_aliases":{"identifier":["hits[].id","hits[].buyer[].id"],"name":["hits[].heading","hits[].buyer[].name"]},"response_example":{"source":"doffin","operation":"search_doffin","parameters":{"query":"","types":["example value"],"statuses":["example value"],"contract_nature":["example value"],"cpv_codes":["example value"],"locations":["example value"],"buyer":["example value"],"winner":["example value"],"date_from":"example value","date_to":"example value","sort_by":"RELEVANCE","page":1,"hits_per_page":10,"include_placeholders":false},"data":{"total_count":1,"hits":[{"id":"example-id","heading":"example value","description":"example value","buyer":[{"id":"example-id","organization_id":"example-id","name":"Example"}],"type":"example value","allTypes":["example value"],"status":"example value","issueDate":"2026-01-15T12:00:00Z","deadline":"2026-01-15T12:00:00Z","publicationDate":"2026-01-15","sentToTed":true,"estimatedValue":{"currencyCode":"example value","amount":1.0},"location_id":["example-id"],"placeOfPerformance":["example value"],"possible_placeholder":true}],"note":"example value"},"entities":[],"_meta":{"retrieved_at":"2026-01-15T12:00:00Z","language":"en","content_languages":["en"],"sources":[{"id":"doffin","name":"Doffin and TED","description":"Search Norwegian and European public procurement, notices and CPV codes.","cache_ttl_seconds":60}]},"_provenance":{"data":{"source":"doffin","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/doffin"},"entities":{"source":"doffin","source_api":"https://allemannsdata.com/wiki/api/v1/kilder/doffin","derived_from":"#/data","description":"Normalized projection of data."}},"_links":{"self":"https://allemannsdata.com/wiki/api/v1/kilder/doffin/search_doffin","source":"https://allemannsdata.com/wiki/api/v1/kilder/doffin","wiki":"https://allemannsdata.com/wiki/kilder/doffin/search_doffin/","feedback":"https://allemannsdata.com/wiki/api/v1/feedback"}}}