{"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'; 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'; 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":"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&include_placeholders=false&limit=25&offset=0","example_url":"https://allemannsdata.com/wiki/api/v1/kilder/doffin/search_doffin?query=sn%C3%B8rydding","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","ENDPOINT_NOT_FOUND"],"retryable":false},"405":{"codes":["METHOD_NOT_ALLOWED"],"retryable":false},"429":{"codes":["RATE_LIMITED","GATEWAY_RATE_LIMITED"],"retryable":true},"503":{"codes":["SOURCE_UNAVAILABLE"],"retryable":true},"500":{"codes":["INTERNAL_ERROR"],"retryable":false}}},"_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"]},"temporal_conventions":{"timezone":"explicit_offset","join_guidance":"date-time fields are RFC 3339 with an explicit offset (Z, +00:00 or the Europe/Oslo offset); compare absolute instants, not clock text. date fields are calendar dates without a time zone.","datetime_fields":["hits[].issueDate","hits[].deadline"],"date_fields":["hits[].publicationDate"]},"response_example":{"source":"doffin","operation":"search_doffin","parameters":{"query":"sn\u00f8rydding","limit":25,"offset":0},"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.","publisher":"Direktoratet for forvaltning og \u00f8konomistyring (DF\u00d8)","license":"https://creativecommons.org/licenses/by/4.0/","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"}}}