{"openapi":"3.1.0","info":{"title":"getBolag API","version":"1.0.0","summary":"Svensk bolagsdata för internt bruk: sök, bolagsprofil, roller, historik, bokslut och engagemang.","description":"REST-API för svensk bolagsdata. Uppgifterna levereras av Creditsafe i Sverige AB och anges i `meta.attribution` i varje svar.\ngetBolag är ett varumärke i Bolagskällan AB (559555-5946).\n\n**Nycklar.** `gb_test_…` går mot sandlådan med påhittade bolag, kostar inget och fungerar direkt. `gb_live_…` går mot registret och debiteras per uppslag. MCP-klienter använder OAuth-token (`gbo_at_…`).\n\n**Live-data är inte öppnad ännu.** Tills villkor och tillstånd är klara svarar live-nycklar `503 blocked_by_phase`. Bygg och testa med en testnyckel; `GET /api/v1/account` visar `live_data_open`.\n\n**Gränser.** Högst 120 anrop per minut och nyckel, 600 per minut och konto, 1000 gratis sökningar per dygn och ett tak för antal olika bolag per dygn. Ingen bulk eller export.\n\n**Personer** identifieras med `person_ref`, som är bundet till ditt konto. Inga personnummer lämnas ut.\n\nExemplen kommer från sandlådan (påhittad testdata).","termsOfService":"https://getapi.gradientvibe.se/villkor","contact":{"name":"getBolag","email":"support@getbolag.se","url":"https://getapi.gradientvibe.se/docs"}},"servers":[{"url":"https://getapi.gradientvibe.se/api/v1"}],"security":[{"bearer":[]}],"tags":[{"name":"Bolag","description":"Sök och slå upp bolag."},{"name":"Personer","description":"Engagemang för en person via person_ref."},{"name":"Konto","description":"Kontot och nyckeln. Gratis."}],"paths":{"/companies/search":{"get":{"operationId":"search_companies","summary":"Sök bolag","description":"Sök på namn (minst fyra tecken) eller organisationsnummer. Högst 10 träffar. Enskilda firmor hittas bara på exakt nummer.\n\nPris: gratis per uppslag (live). Scope: `companies:read`.","tags":["Bolag"],"security":[{"bearer":["companies:read"]}],"x-operation":"search_companies","x-price-sek":0,"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","maxLength":200},"example":"Exempelbolaget"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10}},{"name":"only_active","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/SearchResult"},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"status":"ok","data":[{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","legal_form_code":"AB","match":"normalized"},{"org_number":"569900-0070","name":"Nyföretaget Exempel AB","legal_form_code":"AB","match":"similar"}],"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"search":"available"}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/companies/{org_number}":{"get":{"operationId":"get_company","summary":"Hämta bolag","description":"Bolagsprofil. Med `detail=full` även adresser, verksamhet, tidigare namn, aktiekapital och skatteregistrering (operation `get_company_full`, 0,10 kr).\n\nPris: 0,05 kr per uppslag (live). Scope: `companies:read`.","tags":["Bolag"],"security":[{"bearer":["companies:read"]}],"x-operation":["get_company","get_company_full"],"x-price-sek":0.05,"parameters":[{"name":"org_number","in":"path","required":true,"description":"Organisationsnummer, tio siffror med eller utan bindestreck (även tolv siffror med sekel).","schema":{"type":"string"},"example":"569900-0013"},{"name":"detail","in":"query","required":false,"schema":{"type":"string","enum":["concise","full"],"default":"concise"}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/Company"},"meta":{"$ref":"#/components/schemas/Meta"}}},{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/CompanyFull"},"meta":{"$ref":"#/components/schemas/Meta"}}}]},"examples":{"concise":{"summary":"detail=concise","value":{"status":"ok","data":{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","legal_form":{"code":"AB","text":"Aktiebolag"},"is_sole_trader":false,"status":{"active":true,"code":100,"text":"Aktiv","detailed":"Aktiv","date":null},"registered_date":"2015-03-10","deregistered_date":null,"dissolved_date":null,"seat":{"municipality":"Umeå","region":"Västerbottens län"},"industry":{"sni_code":"62010","text":"Dataprogrammering"}},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"company":"available"}}}},"full":{"summary":"detail=full","value":{"status":"ok","data":{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","legal_form":{"code":"AB","text":"Aktiebolag"},"is_sole_trader":false,"status":{"active":true,"code":100,"text":"Aktiv","detailed":"Aktiv","date":null},"registered_date":"2015-03-10","deregistered_date":null,"dissolved_date":null,"seat":{"municipality":"Umeå","region":"Västerbottens län"},"industry":{"sni_code":"62010","text":"Dataprogrammering"},"formed_date":"2015-03-02","f_tax":{"registered":true,"start_date":"2015-04-01","end_date":null},"vat":{"registered":true,"start_date":"2015-04-01","end_date":null},"phone":"08-000 00 00","workplaces":1,"employees_interval":"10 - 19 anställda","turnover_interval":"10 000 - 19 999 tkr","business_activity":"Bolaget ska utveckla och sälja programvara samt bedriva därmed förenlig verksamhet.","addresses":[{"type":"postal","co":null,"street":"Testvägen 1","zipcode":"90000","town":"UMEÅ","country":"SE","current":true},{"type":"visiting","co":null,"street":"Exempelgatan 2","zipcode":"90001","town":"UMEÅ","country":"SE","current":true}],"previous_names":[{"date":"2019-06-01","old_name":"Exempelbolaget AB","new_name":"Exempelbolaget i Norrland AB"}],"share_capital":{"share_capital":50000,"number_of_shares":500}},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"company":"available","addresses":"available","share_capital":"available"}}}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hittades inte i källan (not_found). Debiteras inte. Svaret har meta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/companies/{org_number}/roles":{"get":{"operationId":"get_company_roles","summary":"Hämta roller","description":"Styrelse, VD, revisorer och firmateckning. Personer får en person_ref i stället för personnummer.\n\nPris: 0,10 kr per uppslag (live). Scope: `roles:read`.","tags":["Bolag"],"security":[{"bearer":["roles:read"]}],"x-operation":"get_company_roles","x-price-sek":0.1,"parameters":[{"name":"org_number","in":"path","required":true,"description":"Organisationsnummer, tio siffror med eller utan bindestreck (även tolv siffror med sekel).","schema":{"type":"string"},"example":"569900-0013"},{"name":"include_former","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Ta med avgångna funktionärer och avslutade engagemang."},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/Roles"},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"status":"ok","data":{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","roles":[{"person_ref":"pr_ZHEiPMYm9PT1SLEv4grsJUODA-g23VoXkPSbw4nWvpKysLel9fdR0jCQLc4","name":"Testsson, Testa","first_name":"Testa","last_name":"Testsson","role_code":10,"role":"Verkställande direktör","from_date":"2015-03-10","to_date":null,"active":true,"legal_entity":null},{"person_ref":"pr_ZHEiPMYm9PT1SLEv4grsJUODA-g23VoXkPSbw4nWvpKysLel9fdR0jCQLc4","name":"Testsson, Testa","first_name":"Testa","last_name":"Testsson","role_code":20,"role":"Styrelseledamot","from_date":"2015-03-10","to_date":null,"active":true,"legal_entity":null},{"person_ref":"pr_4vM6KNWoWO2lD5dgpQKoOyCDazt1I-wO-5QZXfjqoeCDCPUp4s-EwfjOCxQ","name":"Provsdotter, Prov","first_name":"Prov","last_name":"Provsdotter","role_code":30,"role":"Styrelsesuppleant","from_date":"2018-01-01","to_date":null,"active":true,"legal_entity":null},{"person_ref":null,"name":"Revisionsbyrån Exempel AB","first_name":null,"last_name":null,"role_code":40,"role":"Revisor","from_date":"2015-03-10","to_date":null,"active":true,"legal_entity":{"org_number":"569900-0088"}}],"signatory_rights":["Styrelsen. Firman tecknas av styrelsens ledamöter två i förening.","Verkställande direktören har rätt att teckna firman beträffande löpande förvaltningsåtgärder."]},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"roles":"available","signatory_rights":"available"}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hittades inte i källan (not_found). Debiteras inte. Svaret har meta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/companies/{org_number}/history":{"get":{"operationId":"get_company_history","summary":"Hämta historik","description":"Registrerade ändringar och statushistorik.\n\nPris: 0,50 kr per uppslag (live). Scope: `history:read`.","tags":["Bolag"],"security":[{"bearer":["history:read"]}],"x-operation":"get_company_history","x-price-sek":0.5,"parameters":[{"name":"org_number","in":"path","required":true,"description":"Organisationsnummer, tio siffror med eller utan bindestreck (även tolv siffror med sekel).","schema":{"type":"string"},"example":"569900-0013"},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date"},"example":"2026-01-01"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/History"},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"status":"ok","data":{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","events":[{"date":"2026-08-19","code":"ADR","text":"Ändrad postadress","detail":null},{"date":"2026-05-04","code":"STY","text":"Ändring i styrelsen","detail":"Ny styrelsesuppleant registrerad"}],"events_coverage":{"from":"2026-04-12","to":"2026-10-25"},"status_history":[]},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"events":"available","status_history":"not_found"}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hittades inte i källan (not_found). Debiteras inte. Svaret har meta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/companies/{org_number}/financials":{"get":{"operationId":"get_financials","summary":"Hämta bokslut","description":"Bokslut och nyckeltal för aktiebolag, senaste 1–5 åren. För andra bolagsformer är täckningen `restricted`.\n\nPris: 0,10 kr per uppslag (live). Scope: `financials:read`.","tags":["Bolag"],"security":[{"bearer":["financials:read"]}],"x-operation":"get_financials","x-price-sek":0.1,"parameters":[{"name":"org_number","in":"path","required":true,"description":"Organisationsnummer, tio siffror med eller utan bindestreck (även tolv siffror med sekel).","schema":{"type":"string"},"example":"569900-0013"},{"name":"years","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":5,"default":5}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/Financials"},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"status":"ok","data":{"org_number":"569900-0013","name":"Exempelbolaget i Norrland AB","currency_unit":"tsek","statements":[{"period_from":"2025-01-01","period_to":"2025-12-31","months":12,"employees":14,"amounts_tsek":{"net_sales":15200,"operating_income":null,"operating_result":1800,"result_after_financial_items":null,"net_profit":1350,"personnel_costs":null,"depreciation":null,"tax":null,"fixed_assets":null,"current_assets":null,"cash_and_bank":null,"total_assets":9800,"share_capital":null,"equity":4100,"untaxed_reserves":null,"provisions":null,"long_term_liabilities":null,"current_liabilities":null,"total_equity_and_liabilities":null,"dividend":500,"ebitda":null},"ratios":{"operating_margin_percent":11.8,"profit_margin_percent":null,"equity_ratio_percent":41.8,"quick_ratio_percent":null,"return_on_equity_percent":null,"return_on_capital_employed_percent":null,"turnover_change_percent":null,"turnover_per_employee":null,"debt_ratio":null}},{"period_from":"2024-01-01","period_to":"2024-12-31","months":12,"employees":12,"amounts_tsek":{"net_sales":13100,"operating_income":null,"operating_result":1500,"result_after_financial_items":null,"net_profit":1120,"personnel_costs":null,"depreciation":null,"tax":null,"fixed_assets":null,"current_assets":null,"cash_and_bank":null,"total_assets":8700,"share_capital":null,"equity":3250,"untaxed_reserves":null,"provisions":null,"long_term_liabilities":null,"current_liabilities":null,"total_equity_and_liabilities":null,"dividend":0,"ebitda":null},"ratios":{"operating_margin_percent":11.5,"profit_margin_percent":null,"equity_ratio_percent":37.4,"quick_ratio_percent":null,"return_on_equity_percent":null,"return_on_capital_employed_percent":null,"turnover_change_percent":null,"turnover_per_employee":null,"debt_ratio":null}}]},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"financials":"available"}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hittades inte i källan (not_found). Debiteras inte. Svaret har meta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/persons/{person_ref}/engagements":{"get":{"operationId":"get_person_engagements","summary":"Hämta engagemang","description":"Personens roller i bolag. person_ref hämtas från ett rollsvar och fungerar bara för ditt konto. Enskilda firmors nummer visas inte.\n\nPris: 0,10 kr per uppslag (live). Scope: `persons:read`.","tags":["Personer"],"security":[{"bearer":["persons:read"]}],"x-operation":"get_person_engagements","x-price-sek":0.1,"parameters":[{"name":"person_ref","in":"path","required":true,"schema":{"type":"string","pattern":"^pr_[A-Za-z0-9_-]+$"}},{"name":"include_former","in":"query","required":false,"schema":{"type":"string","enum":["true","false"],"default":"false"},"description":"Ta med avgångna funktionärer och avslutade engagemang."},{"name":"Idempotency-Key","in":"header","required":false,"description":"Valfri, högst 100 tecken. Görs exakt samma anrop om med samma nyckel efter ett lyckat svar debiteras det inte igen. Samma nyckel för ett annat anrop ger 422 idempotency_key_reused.","schema":{"type":"string","maxLength":100}}],"responses":{"200":{"description":"Svar med data och meta.","content":{"application/json":{"schema":{"type":"object","required":["status","data","meta"],"properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/Engagements"},"meta":{"$ref":"#/components/schemas/Meta"}}},"example":{"status":"ok","data":{"person_ref":"pr_ZHEiPMYm9PT1SLEv4grsJUODA-g23VoXkPSbw4nWvpKysLel9fdR0jCQLc4","name":"Testsson, Testa","engagements":[{"company":{"org_number":"569900-0013","org_number_withheld":false,"name":"Exempelbolaget i Norrland AB","legal_form_code":"AB"},"role_code":10,"role":"Verkställande direktör","from_date":"2015-03-10","to_date":null,"active":true},{"company":{"org_number":"569900-0013","org_number_withheld":false,"name":"Exempelbolaget i Norrland AB","legal_form_code":"AB"},"role_code":20,"role":"Styrelseledamot","from_date":"2015-03-10","to_date":null,"active":true},{"company":{"org_number":"569900-0039","org_number_withheld":false,"name":"Fiktiva Konsult AB","legal_form_code":"AB"},"role_code":20,"role":"Styrelseledamot","from_date":"2012-05-15","to_date":"2020-01-01","active":false}]},"meta":{"request_id":"6f1c2a54-0b7e-4c1e-9a43-5d2a8f7c9e10","source":["sandbox"],"attribution":[{"source":"getbolag-sandbox","supplier":"getBolag","notice":"Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."}],"retrieved_at":"2026-10-26T09:30:00.000Z","data_updated_at":"2026-10-26T06:00:00Z","cost_sek":0,"environment":"test","database":"getBolag (getbolag.se)","publisher":"getBolag, ett varumärke i Bolagskällan AB (559555-5946)","coverage":{"engagements":"available"}}}}}},"400":{"description":"Ogiltig parameter (invalid_org_number, invalid_parameter, invalid_idempotency_key …).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Krediterna eller ett kostnadstak räcker inte (insufficient_credits, monthly_cap_reached, key_daily_cap_reached).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Hittades inte i källan (not_found). Debiteras inte. Svaret har meta.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"422":{"description":"Idempotency-Key har redan använts för ett annat anrop (idempotency_key_reused).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Live-data inte öppnad (blocked_by_phase), åtkomsten stoppad (suspended) eller tjänsten inte konfigurerad (not_configured).","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/NotConfigured"}]}}}}}}},"/account":{"get":{"operationId":"get_account","summary":"Hämta konto","description":"Konto, saldo, månadens förbrukning och nyckelns miljö och scopes. Gratis och mäts inte.","tags":["Konto"],"security":[{"bearer":[]}],"responses":{"200":{"description":"Kontot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountResponse"}}}},"401":{"description":"Ingen eller ogiltig nyckel (unauthorized). Svaret har WWW-Authenticate: Bearer.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Nyckeln saknar scope eller kontot är inte aktivt (insufficient_scope, account_not_active, email_not_verified, user_disabled).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"För många anrop eller dygnstak nått (rate_limited, entity_cap_exceeded, search_quota_exceeded). Se Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"API-nyckel (gb_live_… eller gb_test_…) eller OAuth-token (gbo_at_…). Scopes: companies:read (Sök och bolagsprofil), roles:read (Styrelse, roller och firmateckning), history:read (Historik och ändringar), financials:read (Bokslut och nyckeltal (AB)), persons:read (Personers engagemang)."}},"schemas":{"Coverage":{"type":"string","enum":["available","not_found","not_collected","restricted","blocked_by_phase","unavailable"],"description":"Täckning per sektion i svaret."},"Attribution":{"type":"object","required":["source","supplier","notice"],"properties":{"source":{"type":"string"},"supplier":{"type":"string","description":"Leverantören av uppgifterna. För live-data Creditsafe i Sverige AB."},"notice":{"type":"string"}}},"Meta":{"type":"object","required":["request_id","source","attribution","retrieved_at","cost_sek","environment","database","publisher","coverage"],"properties":{"request_id":{"type":"string","format":"uuid"},"source":{"type":"array","items":{"type":"string","enum":["creditsafe-bulk","sandbox"]}},"attribution":{"type":"array","items":{"$ref":"#/components/schemas/Attribution"}},"retrieved_at":{"type":"string","format":"date-time"},"data_updated_at":{"type":["string","null"],"format":"date-time"},"cost_sek":{"type":"number","description":"Vad anropet kostade, exklusive moms. 0 för testnycklar, inte hittat och upprepad Idempotency-Key."},"environment":{"type":"string","enum":["live","test"]},"database":{"type":"string"},"publisher":{"type":"string"},"coverage":{"type":"object","additionalProperties":{"$ref":"#/components/schemas/Coverage"}}}},"Error":{"type":"object","required":["status","error"],"properties":{"status":{"const":"error"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","enum":["unauthorized","insufficient_scope","blocked_by_phase","rate_limited","insufficient_credits","monthly_cap_reached","key_daily_cap_reached","entity_cap_exceeded","search_quota_exceeded","suspended","account_not_active","email_not_verified","user_disabled","invalid_org_number","invalid_query","query_too_short","invalid_since","invalid_person_ref","invalid_parameter","invalid_idempotency_key","idempotency_key_reused","not_found","method_not_allowed","internal_error"]},"message":{"type":"string","description":"Förklaring på svenska."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"description":"Hela meta när källan har frågats (till exempel not_found), annars bara request_id.","oneOf":[{"$ref":"#/components/schemas/Meta"},{"type":"object","required":["request_id"],"properties":{"request_id":{"type":"string"}}}]}}},"NotConfigured":{"type":"object","required":["status","error"],"properties":{"status":{"const":"not_configured"},"error":{"type":"object","properties":{"code":{"const":"not_configured"},"message":{"type":"string"}}}}},"SearchHit":{"type":"object","properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]},"name":{"type":["string","null"]},"legal_form_code":{"type":["string","null"]},"match":{"type":"string","enum":["exact","normalized","similar"]}}},"SearchResult":{"type":"array","maxItems":10,"items":{"$ref":"#/components/schemas/SearchHit"}},"Company":{"type":"object","properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]},"name":{"type":["string","null"]},"legal_form":{"type":["object","null"],"properties":{"code":{"type":["string","null"]},"text":{"type":["string","null"]}}},"is_sole_trader":{"type":"boolean"},"status":{"type":"object","properties":{"active":{"type":"boolean"},"code":{"type":["integer","null"]},"text":{"type":["string","null"]},"detailed":{"type":["string","null"]},"date":{"type":["string","null"],"format":"date"}}},"registered_date":{"type":["string","null"],"format":"date"},"deregistered_date":{"type":["string","null"],"format":"date"},"dissolved_date":{"type":["string","null"],"format":"date"},"seat":{"type":"object","properties":{"municipality":{"type":["string","null"]},"region":{"type":["string","null"]}}},"industry":{"type":["object","null"],"properties":{"sni_code":{"type":"string"},"text":{"type":["string","null"]}}}}},"CompanyFull":{"allOf":[{"$ref":"#/components/schemas/Company"},{"type":"object","properties":{"formed_date":{"type":["string","null"],"format":"date"},"f_tax":{"type":"object","properties":{"registered":{"type":["boolean","null"]},"start_date":{"type":["string","null"],"format":"date"},"end_date":{"type":["string","null"],"format":"date"}}},"vat":{"type":"object","properties":{"registered":{"type":["boolean","null"]},"start_date":{"type":["string","null"],"format":"date"},"end_date":{"type":["string","null"],"format":"date"}}},"phone":{"type":["string","null"]},"workplaces":{"type":["integer","null"]},"employees_interval":{"type":["string","null"]},"turnover_interval":{"type":["string","null"]},"business_activity":{"type":["string","null"]},"addresses":{"type":"array","items":{"type":"object","properties":{"type":{"type":["string","null"]},"co":{"type":["string","null"]},"street":{"type":["string","null"]},"zipcode":{"type":["string","null"]},"town":{"type":["string","null"]},"country":{"type":["string","null"]},"current":{"type":["boolean","null"]}}}},"previous_names":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"],"format":"date"},"old_name":{"type":["string","null"]},"new_name":{"type":["string","null"]}}}},"share_capital":{"type":["object","null"],"properties":{"share_capital":{"type":["number","null"]},"number_of_shares":{"type":["number","null"]}}}}}]},"Role":{"type":"object","properties":{"person_ref":{"type":["string","null"],"description":"Handtag för personen, bundet till ditt konto. Används med /persons/{person_ref}/engagements. Null för juridiska personer."},"name":{"type":["string","null"]},"first_name":{"type":["string","null"]},"last_name":{"type":["string","null"]},"role_code":{"type":["integer","null"]},"role":{"type":["string","null"]},"from_date":{"type":["string","null"],"format":"date"},"to_date":{"type":["string","null"],"format":"date"},"active":{"type":["boolean","null"]},"legal_entity":{"type":["object","null"],"properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]}}}}},"Roles":{"type":"object","properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]},"name":{"type":["string","null"]},"roles":{"type":"array","items":{"$ref":"#/components/schemas/Role"}},"signatory_rights":{"type":"array","items":{"type":"string"}}}},"History":{"type":"object","properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]},"name":{"type":["string","null"]},"events":{"type":"array","items":{"type":"object","properties":{"date":{"type":["string","null"],"format":"date"},"code":{"type":["string","null"]},"text":{"type":["string","null"]},"detail":{"type":["string","null"]}}}},"events_coverage":{"type":"object","properties":{"from":{"type":["string","null"],"format":"date"},"to":{"type":["string","null"],"format":"date"}},"description":"Perioden som händelserna täcker."},"status_history":{"type":"array","items":{"type":"object","properties":{"valid_from":{"type":["string","null"],"format":"date"},"valid_to":{"type":["string","null"],"format":"date"},"current":{"type":["boolean","null"]},"status_code":{"type":["integer","null"]},"status":{"type":["string","null"]},"status_detailed":{"type":["string","null"]},"legal_form_code":{"type":["string","null"]},"municipality":{"type":["string","null"]},"f_tax_registered":{"type":["boolean","null"]},"vat_registered":{"type":["boolean","null"]},"deregistered_date":{"type":["string","null"],"format":"date"}}}}}},"Financials":{"type":"object","properties":{"org_number":{"type":"string","pattern":"^\\d{6}-\\d{4}$","examples":["569900-0013"]},"name":{"type":["string","null"]},"currency_unit":{"const":"tsek","description":"Beloppen är i tusental kronor."},"statements":{"type":"array","items":{"type":"object","properties":{"period_from":{"type":"string","format":"date"},"period_to":{"type":"string","format":"date"},"months":{"type":["integer","null"]},"employees":{"type":["integer","null"]},"amounts_tsek":{"type":"object","additionalProperties":{"type":["number","null"]}},"ratios":{"type":"object","additionalProperties":{"type":["number","null"]}}}}}}},"Engagements":{"type":"object","properties":{"person_ref":{"type":"string"},"name":{"type":["string","null"]},"engagements":{"type":"array","items":{"type":"object","properties":{"company":{"type":"object","properties":{"org_number":{"type":["string","null"],"description":"Null för enskilda firmor: numret är innehavarens personnummer och lämnas inte ut här."},"org_number_withheld":{"type":"boolean"},"name":{"type":["string","null"]},"legal_form_code":{"type":["string","null"]}}},"role_code":{"type":["integer","null"]},"role":{"type":["string","null"]},"from_date":{"type":["string","null"],"format":"date"},"to_date":{"type":["string","null"],"format":"date"},"active":{"type":["boolean","null"]}}}}}},"Account":{"type":"object","properties":{"account":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"org_number":{"type":"string"},"status":{"type":"string"},"tier":{"type":"string"}}},"credits":{"type":"object","properties":{"balance_sek":{"type":"number"},"monthly_cap_sek":{"type":"number"},"used_this_month_sek":{"type":"number"},"requests_this_month":{"type":"integer"},"searches_today":{"type":"integer"},"free_searches_per_day":{"type":"integer"},"daily_entity_cap":{"type":"integer"}}},"credential":{"type":"object","properties":{"type":{"type":"string","enum":["api_key","oauth"]},"id":{"type":"string"},"environment":{"type":"string","enum":["live","test"]},"scopes":{"type":"array","items":{"type":"string","enum":["companies:read","roles:read","history:read","financials:read","persons:read"]}},"daily_cost_cap_sek":{"type":["number","null"]}}},"live_data_open":{"type":"boolean","description":"false medan live-data inte är öppnad. Då ger live-nycklar blocked_by_phase; testnycklar fungerar mot sandlådan."}}},"AccountResponse":{"type":"object","properties":{"status":{"const":"ok"},"data":{"$ref":"#/components/schemas/Account"},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"retrieved_at":{"type":"string","format":"date-time"},"database":{"type":"string"},"publisher":{"type":"string"}}}}}}}}