API och MCP

Koppla din egen AI eller ditt eget system till registret. API:t kör samma matchning som bevakningsmejlet och svarar med samma motivering, så en träff i ett agentflöde och en rad i måndagsmejlet är samma sak.

Nycklar ingår i Tilldelat Pro: 1 000 anrop per dygn i hela landet, för 9 950 kr/år eller 995 kr/mån ex moms, se priser. Själva registret är gratis att läsa på webben utan konto.

Kom igång

Skapa en nyckel under Mitt konto → API. Den visas en gång. Skicka den som Bearer-token, eller som X-API-Key i klienter som bara har ett fält för nyckel i en namngiven header:

curl "https://bxpavdursxkyboovtsbj.supabase.co/functions/v1/api/upphandlingar?cpv=45&lan=SE312" \
  -H "Authorization: Bearer tld_xxxxxxxx_..."

Endpoints

GET /upphandlingar

Öppna upphandlingar som matchar dina kriterier.

cpv: Kommaseparerade CPV-prefix, t.ex. 45,90. Utelämnas = alla.
lan: Kommaseparerade NUTS-koder, t.ex. SE312.
q: Nyckelord som ska finnas i titel eller beskrivning.
uteslut: Nyckelord som utesluter en träff.
stangda: 1 för att även ta med passerad sista anbudsdag.
limit: Antal rader, max 200. Standard 50.

GET /tilldelningar

Tilldelade kontrakt, med vinnande leverantör och belopp.

sedan: Datum, ÅÅÅÅ-MM-DD. Standard: 30 dagar bakåt.
cpv, lan, q, uteslut, limit: Som ovan.

GET /avtal-loper-ut

Avtal som närmar sig sitt slut, med verkligt slutdatum. Uppskattade datum ingår aldrig.

dagar: Horisont i dagar, max 1095. Standard 270.
cpv, lan, q, uteslut, limit: Som ovan.

GET /bevakning

Kör en av dina egna sparade bevakningar och få träffarna med motivering.

id: Bevakningens id, syns under Mitt konto → Bevakningar.

GET /profil

Din sparade företagsprofil mot öppna upphandlingar: de bäst passande med bedömning och motivering. Kräver en profil under Mitt konto → Profil.

limit: Antal rader, max 200. Standard 20.

GET /upphandling

En upphandling i detalj: beskrivning, CPV-koder med namn, köpare, län, sista anbudsdag och uppskattat värde.

slug: Slug från source_url, eller hela adressen på tilldelat.se.

GET /kopare

Profil för en köpare: öppna upphandlingar, senaste tilldelningar, avtal som löper ut med verkligt slutdatum, största leverantörer och liknande köpare.

q: Köparens namn. Flera träffar ger en kandidatlista med slug.
slug: Slug eller adress på tilldelat.se, i stället för q.

GET /leverantor

Profil för en leverantör: vunna kontrakt, branscher och konkurrenter som vinner hos samma köpare.

q, slug: Som för kopare.

GET /koder

Slår upp CPV-prefix och länskoder från fritext, t.ex. städning Skåne. Kräver ingen nyckel och räknas inte mot dygnsgränsen.

q: Bransch, tjänst eller ort i fritext.

Svaret

Varje svar bär kalla, kalla_url och din förbrukning, och varje rad har en source_url till sidan på tilldelat.se. Citera gärna källan när du svarar utifrån datat.

{
  "kalla": "Tilldelat",
  "kalla_url": "https://tilldelat.se",
  "plan": "vaksamhet",
  "quota_daily": 300,
  "used_today": 12,
  "plan_lan": ["SE312"],
  "antal": 1,
  "visade": 1,
  "upphandlingar": [
    {
      "title": "Asfaltering Borlänge",
      "buyer_name": "Borlänge kommun",
      "lan_name": "Dalarnas län",
      "deadline": "2026-09-11",
      "reason_sv": "Kategori 45233222 Vägbeläggningsarbeten",
      "source_url": "https://tilldelat.se/upphandling/api-asfalt"
    }
  ]
}

Fel

Kod	Betyder
401	Nyckeln saknas, är fel eller är återkallad.
403	Din plan saknar API, eller du bad om ett län planen inte täcker.
409	Din plan utgår från dina bevakningars län och du har inga än.
429	Dygnsgränsen är nådd. Den nollställs vid midnatt.

MCP

Samma register som MCP-server, så att en assistent kan fråga direkt i stället för att du klistrar in svar. Nio verktyg: sök upphandlingar, sök tilldelningar, avtal som löper ut, kör en av dina egna bevakningar, matcha din företagsprofil, hämta en upphandling, en köpare eller en leverantör i detalj, och slå upp CPV-koder och län från fritext.

Enklaste vägen: lägg in adressen nedan i din assistent och följ inloggningen. Appen registrerar sig själv, du loggar in som vanligt och godkänner kopplingen på en sida hos oss. Ingen nyckel att kopiera. Du ser och kopplar bort anslutna appar under Mitt konto → API. Steg för steg per klient, även Microsoft 365 Copilot, finns på Koppla din AI.

https://mcp.tilldelat.se/mcp

Klienter som inte kan logga in åt dig tar i stället en nyckel i en konfigurationsfil:

{
  "mcpServers": {
    "tilldelat": {
      "url": "https://mcp.tilldelat.se/mcp",
      "headers": { "Authorization": "Bearer tld_xxxxxxxx_..." }
    }
  }
}

Handskakningen och verktygslistan kostar inga anrop. Varje verktygsanrop räknas mot dygnsgränsen.

Villkor

Nyckeln är personlig och får inte delas vidare. Publicerar du något som bygger på datat, ange Tilldelat som källa och länka till sidan. Allmänna villkor gäller. Registret är fritt att läsa på tilldelat.se, men uttag till egna system görs via nyckeln, se använda registret.