search_doffin

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)

Direct GET

For navigating agents: open the HTML page with parameters in the URL. The result is fetched and displayed without screenshots or form filling.

Open this validated HTML GET URL

https://allemannsdata.com/wiki/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

Replace {query}, {types}, {statuses}, {contract_nature}, {cpv_codes}, {locations}, {buyer}, {winner}, {date_from}, {date_to}, {sort_by}, {page}, {hits_per_page}, {include_placeholders} with values. Remove unused optional parameters from the URL.

For software and dashboards: Read the operation descriptor. The JSON GET template is 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. Open this exact request as JSON.

ParameterRequirementJSON typeDescription
queryoptionalstringFree-text search (Norwegian or English), e.g. "IT-drift", "snørydding", "rammeavtale konsulent". Start here.
typesoptionalunionFilter 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.
statusesoptionalunionACTIVE (open for bids), EXPIRED, AWARDED, CANCELLED.
contract_natureoptionalunionWORKS, SERVICES and/or SUPPLIES.
cpv_codesoptionalunion8-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.
locationsoptionalunionNUTS-style location ids, e.g. ["NO060"] (Trøndelag), or "anyw" for non-location-bound. See list_location_codes().
buyeroptionalunionBuyer 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.
winneroptionalunionDoffin's internal supplier id (32-hex). Winner names cannot be used - they are not present in search results to resolve against.
date_fromoptionalunionPublication date lower bound, "YYYY-MM-DD".
date_tooptionalunionPublication date upper bound, "YYYY-MM-DD".
sort_byoptionalstringRELEVANCE (default), PUBLICATION_DATE_DESC, PUBLICATION_DATE_ASC, DEADLINE, ESTIMATED_VALUE_ASC, ESTIMATED_VALUE_DESC.
pageoptionalinteger1-based page number.
hits_per_pageoptionalinteger1-50 (default 10).
include_placeholdersoptionalbooleanBy 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.
limitoptionalintegerGateway page size; default 25, maximum 100.
offsetoptionalintegerNumber of list items to skip; default 0.
Generated JavaScript, Python and response structure

Use JSON when the user requests code, machine-readable data, value extraction or further computation. Use the HTML GET page to identify the correct source and verify parameters.

Example for generated JavaScript and Python

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

Replace URL placeholders and remove unused optional parameters.

JavaScript in a dashboard

const url = "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";
const response = await fetch(url);
if (!response.ok) {
  const failure = await response.json();
  throw new Error(`${failure.error.code}: ${failure.error.message} ${failure.suggestion}`);
}
const result = await response.json();
const data = result.data;

Python without additional packages

import json
from urllib.request import urlopen

url = "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"
with urlopen(url) as response:
    result = json.load(response)
data = result["data"]

Response structure

{
  "source": "doffin",
  "operation": "search_doffin",
  "parameters": {},
  "data": {},
  "entities": [],
  "_meta": {"retrieved_at": "...", "sources": [], "cache": {}},
  "_links": {"self": "...", "source": "...", "wiki": "...", "feedback": "..."}
}
Form for manual use

The form is a fallback for people and browser agents that cannot open the GET URL directly.

Type: string. Free-text search (Norwegian or English), e.g. "IT-drift", "snørydding", "rammeavtale konsulent". Start here.
Type: list of string (comma-separated). 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.
Type: list of string (comma-separated). ACTIVE (open for bids), EXPIRED, AWARDED, CANCELLED.
Type: list of string (comma-separated). WORKS, SERVICES and/or SUPPLIES.
Type: list of string (comma-separated). 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.
Type: list of string (comma-separated). NUTS-style location ids, e.g. ["NO060"] (Trøndelag), or "anyw" for non-location-bound. See list_location_codes().
Type: list of string (comma-separated). 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.
Type: list of string (comma-separated). Doffin's internal supplier id (32-hex). Winner names cannot be used - they are not present in search results to resolve against.
Type: string. Publication date lower bound, "YYYY-MM-DD".
Type: string. Publication date upper bound, "YYYY-MM-DD".
Type: string. RELEVANCE (default), PUBLICATION_DATE_DESC, PUBLICATION_DATE_ASC, DEADLINE, ESTIMATED_VALUE_ASC, ESTIMATED_VALUE_DESC.
Type: integer. 1-based page number.
Type: integer. 1-50 (default 10).
Type: yes/no. 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.

Result

Source: Doffin and TED. Retrieved 2026-11-01T14:26:08Z in 0.143 seconds.

total_count:
3
hits:

3 results

  1. id:
    2023-694654
    buyer:

    1 results

    1. id:
      bd59708df6f3f643b5ed62b237a56af5
      organization_id:
      876 819 902
      name:
      Oslo kommune v/ Klimaetaten
    heading:
    Konsulenttjenester på klima- og energifeltet
    description:
    Klimaetaten har behov for tilgang på strategisk rådgivning knyttet til vurdering og oppfølging av FoU- og pilotprosjekter innen nye energiløsninger og prosjektledelse av mikroenergisystemet på Furuset. Anskaffelsen er delt opp i følgende to delområder. 1. FoU- og pilotprosjekter 2. Mikroenergisystemet Furuset Tilbydere har anledning til å inngi tilbud på ett eller begge delområder. Det skal inngås en rammeavtale for hvert delområde. For delområde 1 – FoU og pilotprosjekter er kontraktens verdi estimert fra 1 til 1,5 millioner kroner eks mva. Maksimal verdi av rammeavtalen settes til 2 millioner kroner eks mva. For Delområde 2 – Mikroenergisystemet Furuset er estimatet på verdi fra 2 til 2,5 millioner kroner eks mva. Maksimal verdi av rammeavtalen settes til 3 millioner kroner eks mva. Det tas forbehold om endringer i tjenestevolum som følge av variasjoner i Klimaetatens behov fra år til år og tilgjengelig budsjettmidler.
    location_id:

    No results.

    estimatedValue:
    not reported by source
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2023-02-07T10:00:00Z
    deadline:
    not reported by source
    sentToTed:
    yes
    publicationDate:
    2023-02-07
    placeOfPerformance:

    No results.

    procurementStrategicLabels:

    No results.

  2. id:
    2025-114942
    buyer:

    1 results

    1. id:
      bd59708df6f3f643b5ed62b237a56af5
      organization_id:
      876819902
      name:
      Oslo kommune v/ Klimaetaten
    heading:
    Kjøp av konsulentbistand på energifeltet: Koordinere prosjektet mikroenergisystem Furuset og bistand på området energifleksibilitet
    description:
    Oslo kommune har utviklet et mikroenergisystem på Furuset. Målet med prosjektet er å demonstrere en ny metodikk for organisering av energisystemet der lokalt samspill mellom produksjon og forbruk, digitalisering og helhetlig infrastrukturutbygging står sentralt. Bakgrunnen for prosjektet er å svare på fremtidige utfordringer i energisystemet knyttet til et økende energi- og effektbehov, samt en økende andel fornybar og uregulerbar energiproduksjon. Løsningene som ønskes demonstrert kan potensielt gi en økt fleksibilitet i nettet og er reelle alternativer til dyre investeringer i oppgraderinger av dagens elektriske infrastruktur. Prosjektet gjennomføres som en storskala demonstrasjon av et mikroenergisystem på Furuset. Hafslund Celsio er prosjektleder for prosjektet, mens Klimaetaten har en koordinerende rolle for å holde framdriften i prosjektet. Oppdragstaker skal fylle rollen som koordinator for framdrift av prosjektet Mikroenergisystem på Furuset. Det er behov for at oppdragstaker også bidrar med relevant kompetanse på energi- og klimaområdet i prosjektet, i tillegg til å koordinere og utvikle piloten for tilbud av energifleksibilitet i fleksibilitetsmarkeder. Det kan også være behov for at oppdragstaker bidrar med relevant kompetanse på energiområdet i enkelte andre saker som Klimaetaten jobber med. Ressursen(e) vil ha mulighet til å benytte seg av kontorplass i Klimaetatens kontorlokaler i Olav Vs gate 4 i Oslo. Kontorplassen skal kun benyttes til arbeid gjort på oppdrag for Klimaetaten.
    location_id:

    1 results

    1. NO081
    estimatedValue:
    currencyCode:
    NOK
    amount:
    2000000.0
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2025-10-16T08:52:59Z
    deadline:
    2027-08-01T00:00:00Z
    sentToTed:
    yes
    publicationDate:
    2025-10-17
    placeOfPerformance:
    procurementStrategicLabels:

    No results.

  3. id:
    2017-541833
    buyer:

    1 results

    1. id:
      d5284064b074e7bd3013525b7fe1beb4
      organization_id:
      970141669
      name:
      Norges forskningsråd
    heading:
    Rammeavtale - Konsulenttjenester for ENERGIX-programmet
    description:
    Norgesforskningsråd ved Divisjon for Energi, Ressurser og Miljø (ERM) avdeling forEnergi, innbyr til åpen anbudskonkurranse i forbindelse med inngåelse av rammeavtalefor kjøp av konsulenttjenester for ENERGIX-programmet. Se konkurransegrunnlaget for ytterligereopplysninger.
    location_id:

    1 results

    1. anyw
    estimatedValue:
    not reported by source
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2017-09-06T10:00:00Z
    deadline:
    not reported by source
    sentToTed:
    yes
    publicationDate:
    2017-09-06
    placeOfPerformance:

    No results.

    procurementStrategicLabels:

    No results.

limit:
25
offset:
0
returned:
3
has_more_results:
no
Show all fields in HTML
total_count:
3
hits:

3 results

  1. id:
    2023-694654
    buyer:

    1 results

    1. id:
      bd59708df6f3f643b5ed62b237a56af5
      organization_id:
      876 819 902
      name:
      Oslo kommune v/ Klimaetaten
    heading:
    Konsulenttjenester på klima- og energifeltet
    description:
    Klimaetaten har behov for tilgang på strategisk rådgivning knyttet til vurdering og oppfølging av FoU- og pilotprosjekter innen nye energiløsninger og prosjektledelse av mikroenergisystemet på Furuset. Anskaffelsen er delt opp i følgende to delområder. 1. FoU- og pilotprosjekter 2. Mikroenergisystemet Furuset Tilbydere har anledning til å inngi tilbud på ett eller begge delområder. Det skal inngås en rammeavtale for hvert delområde. For delområde 1 – FoU og pilotprosjekter er kontraktens verdi estimert fra 1 til 1,5 millioner kroner eks mva. Maksimal verdi av rammeavtalen settes til 2 millioner kroner eks mva. For Delområde 2 – Mikroenergisystemet Furuset er estimatet på verdi fra 2 til 2,5 millioner kroner eks mva. Maksimal verdi av rammeavtalen settes til 3 millioner kroner eks mva. Det tas forbehold om endringer i tjenestevolum som følge av variasjoner i Klimaetatens behov fra år til år og tilgjengelig budsjettmidler.
    location_id:

    No results.

    estimatedValue:
    not reported by source
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2023-02-07T10:00:00Z
    deadline:
    not reported by source
    sentToTed:
    yes
    publicationDate:
    2023-02-07
    placeOfPerformance:

    No results.

    procurementStrategicLabels:

    No results.

  2. id:
    2025-114942
    buyer:

    1 results

    1. id:
      bd59708df6f3f643b5ed62b237a56af5
      organization_id:
      876819902
      name:
      Oslo kommune v/ Klimaetaten
    heading:
    Kjøp av konsulentbistand på energifeltet: Koordinere prosjektet mikroenergisystem Furuset og bistand på området energifleksibilitet
    description:
    Oslo kommune har utviklet et mikroenergisystem på Furuset. Målet med prosjektet er å demonstrere en ny metodikk for organisering av energisystemet der lokalt samspill mellom produksjon og forbruk, digitalisering og helhetlig infrastrukturutbygging står sentralt. Bakgrunnen for prosjektet er å svare på fremtidige utfordringer i energisystemet knyttet til et økende energi- og effektbehov, samt en økende andel fornybar og uregulerbar energiproduksjon. Løsningene som ønskes demonstrert kan potensielt gi en økt fleksibilitet i nettet og er reelle alternativer til dyre investeringer i oppgraderinger av dagens elektriske infrastruktur. Prosjektet gjennomføres som en storskala demonstrasjon av et mikroenergisystem på Furuset. Hafslund Celsio er prosjektleder for prosjektet, mens Klimaetaten har en koordinerende rolle for å holde framdriften i prosjektet. Oppdragstaker skal fylle rollen som koordinator for framdrift av prosjektet Mikroenergisystem på Furuset. Det er behov for at oppdragstaker også bidrar med relevant kompetanse på energi- og klimaområdet i prosjektet, i tillegg til å koordinere og utvikle piloten for tilbud av energifleksibilitet i fleksibilitetsmarkeder. Det kan også være behov for at oppdragstaker bidrar med relevant kompetanse på energiområdet i enkelte andre saker som Klimaetaten jobber med. Ressursen(e) vil ha mulighet til å benytte seg av kontorplass i Klimaetatens kontorlokaler i Olav Vs gate 4 i Oslo. Kontorplassen skal kun benyttes til arbeid gjort på oppdrag for Klimaetaten.
    location_id:

    1 results

    1. NO081
    estimatedValue:
    currencyCode:
    NOK
    amount:
    2000000.0
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2025-10-16T08:52:59Z
    deadline:
    2027-08-01T00:00:00Z
    sentToTed:
    yes
    publicationDate:
    2025-10-17
    placeOfPerformance:
    procurementStrategicLabels:

    No results.

  3. id:
    2017-541833
    buyer:

    1 results

    1. id:
      d5284064b074e7bd3013525b7fe1beb4
      organization_id:
      970141669
      name:
      Norges forskningsråd
    heading:
    Rammeavtale - Konsulenttjenester for ENERGIX-programmet
    description:
    Norgesforskningsråd ved Divisjon for Energi, Ressurser og Miljø (ERM) avdeling forEnergi, innbyr til åpen anbudskonkurranse i forbindelse med inngåelse av rammeavtalefor kjøp av konsulenttjenester for ENERGIX-programmet. Se konkurransegrunnlaget for ytterligereopplysninger.
    location_id:

    1 results

    1. anyw
    estimatedValue:
    not reported by source
    type:
    ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    allTypes:

    2 results

    1. ANNOUNCEMENT_OF_CONCLUSION_OF_CONTRACT
    2. RESULT
    status:
    not reported by source
    issueDate:
    2017-09-06T10:00:00Z
    deadline:
    not reported by source
    sentToTed:
    yes
    publicationDate:
    2017-09-06
    placeOfPerformance:

    No results.

    procurementStrategicLabels:

    No results.

limit:
25
offset:
0
returned:
3
has_more_results:
no
Will you use the result in generated code?

Open the same result as JSON

Is data missing or incorrect? Send feedback about this result.

Continue exploring

How an AI agent should use this page

Ground rule: Navigate with HTML GET links to keep explanations and relationships. Use the page's JSON alternative only when concrete values must be extracted, compared or computed.

How to use the search_doffin lookup

  1. Replace the placeholders in the HTML GET template; remove optional parameters you do not need.
  2. Check types, units, limits and ID formats in the parameter table.
  3. Follow linked results to canonical pages before combining sources.

Misreading to avoid: An empty list means "no results for this lookup". An error message or unavailable source does not mean the data does not exist.

Source-specific next step

Go to the source page for other operations. Use the JSON template only after the HTML result shows that the parameters and source are correct.