{"components":{"schemas":{"DagligLeder":{"description":"Daglig leder med den best rangerte verdien per slag. Mobilnummer leveres bare av /v1/telefon/finn.","properties":{"andre_selskaper":{"type":"string"},"epost":{"type":"string"},"epost_alternativer":{"description":"Antall andre kjente adresser (vises ikke).","type":"integer"},"epost_grad":{"$ref":"#/components/schemas/Grad"},"epost_kilde":{"example":"navn i adressen","type":"string"},"epost_sikkerhet":{"enum":["høy","middels","lav",""],"type":"string"},"har_mobil":{"type":"boolean"},"kan_sms":{"type":"boolean"},"linkedin":{"type":"string"},"linkedin_grad":{"$ref":"#/components/schemas/Grad"},"linkedin_kilde":{"type":"string"},"mobil":{"description":"«tilgjengelig» eller tom; selve nummeret fra /v1/telefon/finn.","type":"string"},"mobil_grad":{"$ref":"#/components/schemas/Grad"},"navn":{"type":"string"},"tittel":{"type":"string"}},"type":"object"},"Feil":{"properties":{"feil":{"properties":{"http":{"type":"integer"},"kode":{"enum":["ugyldig_foresporsel","ugyldig_nokkel","ingen_telefonpoeng","ikke_funnet","feil_metode","kvote_brukt","serverfeil"],"type":"string"},"melding":{"type":"string"}},"type":"object"},"meta":{"$ref":"#/components/schemas/Meta"},"status":{"const":"feil","type":"string"}},"type":"object"},"Grad":{"description":"A = bekreftet ved navnet på egen nettside/i register, B = egen/stillingsannonse, C = mønster/annet selskap, D = gjett med støtte, E = gjett. Se /data.","enum":["A","B","C","D","E",""],"type":"string"},"Konvolutt":{"properties":{"melding":{"description":"Forklaring ved ikke_funnet.","type":"string"},"meta":{"$ref":"#/components/schemas/Meta"},"resultat":{"description":"Avhenger av endepunktet; null ved ikke_funnet."},"status":{"description":"ikke_funnet gir HTTP 200 og koster ingenting.","enum":["ok","ikke_funnet","feil"],"type":"string"}},"required":["status","resultat","meta"],"type":"object"},"Kvote":{"properties":{"brukt":{"type":"integer"},"grense":{"type":"integer"},"igjen":{"type":"integer"}},"type":"object"},"Meta":{"description":"Kvotestatus etter kallet, så agenten slipper å spørre /v1/konto.","properties":{"belastet":{"additionalProperties":{"type":"integer"},"description":"Hva dette kallet kostet, f.eks. {\"berikelse\": 1}","type":"object"},"berikelser":{"$ref":"#/components/schemas/Kvote"},"plan":{"enum":["gratis","solo","pro","team"],"type":"string"},"sok":{"$ref":"#/components/schemas/Kvote"},"telefonpoeng":{"type":"integer"},"vindu":{"example":"5 timer","type":"string"}},"type":"object"},"Selskap":{"properties":{"anslag":{"additionalProperties":true,"description":"Våre anslag: kundetype (B2B/B2C/begge/offentlig), betaling (faktura/kort/blandet), utestaende_anslag, kunder_anslag, fakturaer_anslag, dager_anslag","type":"object"},"daglig_leder":{"$ref":"#/components/schemas/DagligLeder"},"regnskap":{"additionalProperties":true,"description":"Siste innsendte årsregnskap i kr: regnskapsaar, omsetning, driftsresultat, aarsresultat, egenkapital, fordringer, fordringer_andel, bank, lonn, aksjekapital","type":"object"},"roller":{"additionalProperties":true,"description":"daglig_leder, styreleder, regnskapsforer, revisor","type":"object"},"selskap":{"additionalProperties":true,"description":"Register: orgnr, navn, orgform, bransje_kode, bransje, ansatte, stiftet, fylke, kommune, poststed, adresse, telefon, mobil, kan_sms, epost, hjemmeside, mva, konsern, morselskap, avdelinger, kjede, holding, linkedin_firma, beskrivelse, tidligere_navn, formaal","type":"object"},"signaler":{"additionalProperties":true,"description":"Fra nettsida: fakturasignaler (purregebyr, inkasso, avtalegiro, efaktura, ehf, abonnement …), fakturerer_mange, betalingsmaate_nettside, regnskapssystem, inkassoselskap","type":"object"}},"type":"object"},"SelskapKort":{"description":"Treff i søk.","properties":{"ansatte":{"type":"integer"},"bransje":{"type":"string"},"bransje_kode":{"type":"string"},"daglig_leder":{"type":"string"},"fylke":{"type":"string"},"har_dl_epost":{"type":"boolean"},"har_dl_linkedin":{"type":"boolean"},"har_dl_mobil":{"type":"boolean"},"hjemmeside":{"type":"string"},"kan_sms":{"type":"boolean"},"kommune":{"type":"string"},"kunder_anslag":{"type":"number"},"kundetype":{"type":"string"},"navn":{"type":"string"},"omsetning":{"type":"number"},"orgnr":{"type":"string"},"stiftet":{"type":"string"},"utestaende_anslag":{"type":"number"}},"type":"object"}},"securitySchemes":{"nokkel":{"bearerFormat":"fs_…","description":"Gratis nøkkel på https://firmasett.arnu.io/konsoll","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"hei@firmasett.no","url":"https://firmasett.arnu.io"},"description":"66 000 norske selskaper med ansatte fullt beriket (siste regnskap, daglig leder med beste e-post/mobil/LinkedIn og kilde, anslag på utestående og kunder), oppdatert hver natt, pluss hele Enhetsregisteret (1,2 mill. enheter) til oppslag på orgnr med registerdata. Alle svar har konvolutten {status, resultat, meta}. ikke_funnet = HTTP 200 uten kostnad. Kvoter per 5-timersvindu. Les også https://firmasett.arnu.io/llms.txt.","summary":"Norsk B2B-søk og berikelse for folk og AI-agenter","termsOfService":"https://firmasett.arnu.io/vilkar","title":"Firmasett API","version":"1.1"},"openapi":"3.1.0","paths":{"/v1/berik/person":{"post":{"description":"Gi orgnr, eller navn + firma/domene. 1 berikelse ved treff. resultat = DagligLeder + orgnr, firma, bransje, fylke, hjemmeside.","operationId":"berikPerson","requestBody":{"content":{"application/json":{"schema":{"properties":{"domene":{"type":"string"},"firma":{"type":"string"},"navn":{"type":"string"},"orgnr":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Berik en person (daglig leder)","tags":["personer"]}},"/v1/bransjer":{"get":{"operationId":"bransjer","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Næringskoder med antall og dekning, pluss fylker","tags":["konto"]}},"/v1/bruk":{"get":{"operationId":"bruk","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Forbruk per dag siste 30 dager","tags":["konto"]}},"/v1/epost/finn":{"post":{"description":"Kjent adresse (grad A/B) hvis personen er daglig leder, ellers domenets bekreftede mønster (C) eller vanligste norske mønster (D) med alternativer. 1 berikelse.","operationId":"finnEpost","requestBody":{"content":{"application/json":{"schema":{"properties":{"domene":{"type":"string"},"etternavn":{"type":"string"},"firma":{"type":"string"},"fornavn":{"type":"string"},"navn":{"type":"string"},"orgnr":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Finn e-post for navn på domene","tags":["epost"]}},"/v1/epost/omvendt":{"get":{"description":"resultat = Selskap + treff (daglig leders adresse | selskapets domene). 1 berikelse ved treff.","operationId":"omvendtEpost","parameters":[{"description":"","in":"query","name":"epost","required":false,"schema":{"type":"string"}},{"description":"","in":"query","name":"domene","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Omvendt oppslag på e-post eller domene","tags":["epost"]}},"/v1/epost/valider":{"post":{"description":"Per adresse: syntaks, domene_svarer (MX/A), rolleadresse, fridomene, engangsdomene, kjent_i_datasettet, vurdering, grad. 1 berikelse per adresse.","operationId":"validerEpost","requestBody":{"content":{"application/json":{"schema":{"properties":{"epost":{"type":"string"},"eposter":{"items":{"type":"string"},"maxItems":100,"type":"array"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Valider inntil 100 e-postadresser","tags":["epost"]}},"/v1/konto":{"get":{"operationId":"konto","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Plan, kvoter og forbruk","tags":["konto"]}},"/v1/onboarding":{"get":{"operationId":"onboarding","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Onboarding: lagret profil, hva som mangler, spørsmålene","tags":["konto"]},"post":{"operationId":"lagreProfil","requestBody":{"content":{"application/json":{"schema":{"properties":{"bestemmer":{"description":"Hva brukeren bestemmer over","type":"string"},"epost":{"type":"string"},"firma":{"type":"string"},"navn":{"type":"string"},"paavirker":{"description":"Hva brukeren påvirker beslutninger om","type":"string"},"telefon":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Lagre svar fra onboardingen (delvis er greit, «-» = hoppet over)","tags":["konto"]}},"/v1/personer/sok":{"get":{"operationId":"sokPersoner","parameters":[{"description":"Fritekst: firmanavn, daglig leder eller orgnr","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Næringskode-prefiks, flere med komma (69.2,85.1)","in":"query","name":"bransje","required":false,"schema":{"type":"string"}},{"description":"Fylke(r), flere med komma","in":"query","name":"fylke","required":false,"schema":{"type":"string"}},{"description":"Kommune","in":"query","name":"kommune","required":false,"schema":{"type":"string"}},{"description":"B2B | B2C | begge | offentlig","in":"query","name":"kundetype","required":false,"schema":{"type":"string"}},{"description":"","in":"query","name":"ansatte_min","required":false,"schema":{"type":"number"}},{"description":"","in":"query","name":"ansatte_maks","required":false,"schema":{"type":"number"}},{"description":"kr","in":"query","name":"omsetning_min","required":false,"schema":{"type":"number"}},{"description":"kr","in":"query","name":"omsetning_maks","required":false,"schema":{"type":"number"}},{"description":"år","in":"query","name":"stiftet_min","required":false,"schema":{"type":"integer"}},{"description":"år","in":"query","name":"stiftet_maks","required":false,"schema":{"type":"integer"}},{"description":"anslått utestående, kr","in":"query","name":"utestaende_min","required":false,"schema":{"type":"number"}},{"description":"","in":"query","name":"utestaende_maks","required":false,"schema":{"type":"number"}},{"description":"anslått antall kunder","in":"query","name":"kunder_min","required":false,"schema":{"type":"number"}},{"description":"anslått fakturaer per år","in":"query","name":"fakturaer_min","required":false,"schema":{"type":"number"}},{"description":"ja|nei – selskapet har mobilnummer","in":"query","name":"kan_sms","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_mobil","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_epost","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_linkedin","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_nettside","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_regnskap","required":false,"schema":{"type":"string"}},{"description":"aktiv (standard) | konkurs | avvikling | tvangsavvikling | alle","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"ja – søk i hele Enhetsregisteret (1,2 mill. enheter, bare navn/orgnr/sted/bransje) i stedet for hoveddatasettet. Treffene har dekning register og teller som søketreff.","in":"query","name":"register","required":false,"schema":{"type":"string"}},{"description":"ja|nei – nettsida nevner purregebyr/inkasso/avtalegiro/efaktura","in":"query","name":"fakturerer_mange","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"kjede","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"konsern","required":false,"schema":{"type":"string"}},{"description":"delstreng i fakturasignaler: purregebyr, inkasso, avtalegiro, efaktura, ehf, abonnement","in":"query","name":"signal","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"regnskapsforer","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"revisor","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"regnskapssystem","required":false,"schema":{"type":"string"}},{"description":"omsetning | ansatte | utestaende | kunder | fakturaer | nyeste | navn","in":"query","name":"sorter","required":false,"schema":{"type":"string"}},{"description":"1–100, standard 25","in":"query","name":"antall","required":false,"schema":{"type":"integer"}},{"description":"standard 1","in":"query","name":"side","required":false,"schema":{"type":"integer"}},{"description":"ja – bare tell treff. Gratis, teller ikke mot kvoten.","in":"query","name":"antall_kun","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"resultat: {total, side, antall, treff: [{navn, tittel, orgnr, firma, bransje, fylke, kommune, ansatte, har_epost, har_mobil, har_linkedin}]}"}},"summary":"Søk daglige ledere","tags":["personer"]}},"/v1/selskaper/berik":{"post":{"description":"Én berikelse per selskap som finnes. resultat: {antall, funnet, resultater: [{orgnr, status, …Selskap}]}","operationId":"berikSelskaper","requestBody":{"content":{"application/json":{"schema":{"properties":{"orgnrs":{"items":{"type":"string"},"maxItems":100,"type":"array"}},"required":["orgnrs"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Berik inntil 100 selskaper","tags":["selskaper"]}},"/v1/selskaper/sok":{"get":{"description":"Hvert treff som leveres teller som ett søketreff. Med antall_kun=ja får du bare totalen, gratis.","operationId":"sokSelskaper","parameters":[{"description":"Fritekst: firmanavn, daglig leder eller orgnr","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"Næringskode-prefiks, flere med komma (69.2,85.1)","in":"query","name":"bransje","required":false,"schema":{"type":"string"}},{"description":"Fylke(r), flere med komma","in":"query","name":"fylke","required":false,"schema":{"type":"string"}},{"description":"Kommune","in":"query","name":"kommune","required":false,"schema":{"type":"string"}},{"description":"B2B | B2C | begge | offentlig","in":"query","name":"kundetype","required":false,"schema":{"type":"string"}},{"description":"","in":"query","name":"ansatte_min","required":false,"schema":{"type":"number"}},{"description":"","in":"query","name":"ansatte_maks","required":false,"schema":{"type":"number"}},{"description":"kr","in":"query","name":"omsetning_min","required":false,"schema":{"type":"number"}},{"description":"kr","in":"query","name":"omsetning_maks","required":false,"schema":{"type":"number"}},{"description":"år","in":"query","name":"stiftet_min","required":false,"schema":{"type":"integer"}},{"description":"år","in":"query","name":"stiftet_maks","required":false,"schema":{"type":"integer"}},{"description":"anslått utestående, kr","in":"query","name":"utestaende_min","required":false,"schema":{"type":"number"}},{"description":"","in":"query","name":"utestaende_maks","required":false,"schema":{"type":"number"}},{"description":"anslått antall kunder","in":"query","name":"kunder_min","required":false,"schema":{"type":"number"}},{"description":"anslått fakturaer per år","in":"query","name":"fakturaer_min","required":false,"schema":{"type":"number"}},{"description":"ja|nei – selskapet har mobilnummer","in":"query","name":"kan_sms","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_mobil","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_epost","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_dl_linkedin","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_nettside","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"har_regnskap","required":false,"schema":{"type":"string"}},{"description":"aktiv (standard) | konkurs | avvikling | tvangsavvikling | alle","in":"query","name":"status","required":false,"schema":{"type":"string"}},{"description":"ja – søk i hele Enhetsregisteret (1,2 mill. enheter, bare navn/orgnr/sted/bransje) i stedet for hoveddatasettet. Treffene har dekning register og teller som søketreff.","in":"query","name":"register","required":false,"schema":{"type":"string"}},{"description":"ja|nei – nettsida nevner purregebyr/inkasso/avtalegiro/efaktura","in":"query","name":"fakturerer_mange","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"kjede","required":false,"schema":{"type":"string"}},{"description":"ja|nei","in":"query","name":"konsern","required":false,"schema":{"type":"string"}},{"description":"delstreng i fakturasignaler: purregebyr, inkasso, avtalegiro, efaktura, ehf, abonnement","in":"query","name":"signal","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"regnskapsforer","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"revisor","required":false,"schema":{"type":"string"}},{"description":"delstreng","in":"query","name":"regnskapssystem","required":false,"schema":{"type":"string"}},{"description":"omsetning | ansatte | utestaende | kunder | fakturaer | nyeste | navn","in":"query","name":"sorter","required":false,"schema":{"type":"string"}},{"description":"1–100, standard 25","in":"query","name":"antall","required":false,"schema":{"type":"integer"}},{"description":"standard 1","in":"query","name":"side","required":false,"schema":{"type":"integer"}},{"description":"ja – bare tell treff. Gratis, teller ikke mot kvoten.","in":"query","name":"antall_kun","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"resultat: {total, side, antall, treff: [SelskapKort]}"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}},"description":"Feil"}},"summary":"Søk selskaper","tags":["selskaper"]}},"/v1/selskaper/{orgnr}":{"get":{"description":"1 berikelse når selskapet er i hoveddatasettet (dekning: full; resultat = selskap, regnskap, anslag, signaler, roller, daglig_leder). Orgnr som bare finnes i Enhetsregisteret gir dekning: register med registerdata, gratis.","operationId":"berikSelskap","parameters":[{"in":"path","name":"orgnr","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}},"description":"Feil"}},"summary":"Berik ett selskap","tags":["selskaper"]}},"/v1/sjekk":{"post":{"description":"Per rad: treff (person|selskap|ingen), orgnr, firma, daglig_leder, epost_status og telefon_status (lik|avviker|vi_mangler|du_mangler|begge_mangler), beste_epost med grad, har_mobil. 1 berikelse per rad med treff. Innsendte data lagres som bidrag (vilkår § 6).","operationId":"sjekk","requestBody":{"content":{"application/json":{"schema":{"properties":{"rader":{"items":{"properties":{"domene":{"type":"string"},"epost":{"type":"string"},"firma":{"type":"string"},"id":{"type":"string"},"linkedin":{"type":"string"},"navn":{"type":"string"},"orgnr":{"type":"string"},"telefon":{"type":"string"},"tittel":{"type":"string"}},"type":"object"},"maxItems":100,"type":"array"}},"required":["rader"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"}},"summary":"Sjekk egne kontakter mot Firmasett","tags":["sjekk"]}},"/v1/telefon/finn":{"post":{"description":"1 telefonpoeng per nummer levert; ikke_funnet koster ingenting. resultat: {orgnr, firma, navn, mobil, kilde, grad, sikkerhet, kan_sms, alternativer, merk}","operationId":"finnMobil","requestBody":{"content":{"application/json":{"schema":{"properties":{"domene":{"type":"string"},"firma":{"type":"string"},"orgnr":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Konvolutt"}}},"description":"Konvolutt"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Feil"}}},"description":"Ingen telefonpoeng"}},"summary":"Mobilnummer til daglig leder","tags":["telefon"]}}},"security":[{"nokkel":[]}],"servers":[{"url":"https://firmasett.arnu.io"}],"tags":[{"description":"Gratis, teller ikke mot kvoten","name":"konto"},{"name":"selskaper"},{"name":"personer"},{"name":"epost"},{"name":"telefon"},{"name":"sjekk"}]}