# Firmasett API – referanse

> Norsk B2B-søk og berikelse for folk og AI-agenter


> 440 022 norske selskaper (alle aktive private, også uten 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.

Base-URL `https://firmasett.arnu.io`. Autentisering: `Authorization: Bearer fs_…` (gratis nøkkel på https://firmasett.arnu.io/konsoll). Maskinlesbar spesifikasjon: https://firmasett.arnu.io/openapi.json. Oversikt og konvolutt: https://firmasett.arnu.io/dok.

Feilkoder (`status: feil`, HTTP 4xx/5xx): `ugyldig_foresporsel`, `ugyldig_nokkel`, `ingen_telefonpoeng`, `ikke_funnet`, `feil_metode`, `kvote_brukt`, `serverfeil`. `ikke_funnet` er HTTP 200 og koster ingenting.


## konto — Gratis, teller ikke mot kvoten


### GET /v1/konto — Plan, kvoter og forbruk

```bash
curl "https://firmasett.arnu.io/v1/konto" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "brukt": {
      "berikelser": 0,
      "sok": 0
    },
    "epost": "eksempel@firmasett.no",
    "grenser": {
      "berikelser": 1000,
      "sok": 100,
      "totalt": true
    },
    "mobilnumre_tilgjengelig": true,
    "opprettet": "2026-11-06T15:26:38",
    "plan": "gratis",
    "plan_navn": "Gratis",
    "telefonpoeng": 5,
    "vindu_timer": 5
  },
  "meta": {
    "belastet": {},
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 0,
      "grense": 100,
      "igjen": 100
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


### GET /v1/bruk — Forbruk per dag siste 30 dager

```bash
curl "https://firmasett.arnu.io/v1/bruk" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "dager": [],
    "fra": "2026-10-07"
  },
  "meta": {
    "belastet": {},
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 0,
      "grense": 100,
      "igjen": 100
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


### GET /v1/onboarding — Onboarding: lagret profil, hva som mangler, spørsmålene

```bash
curl "https://firmasett.arnu.io/v1/onboarding" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "fullfort": true,
    "mangler": [],
    "oppdatert": "2026-11-06T15:26:39",
    "profil": {
      "bestemmer": "innkjøp",
      "epost": "kari@eksempel.no",
      "firma": "Eksempel AS",
      "navn": "Kari Nordmann",
      "paavirker": "-",
      "telefon": "90 •• •• ••"
    },
    "selskaper": 454566,
    "sporsmal": []
  },
  "meta": {
    "belastet": {},
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 0,
      "grense": 100,
      "igjen": 100
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


### POST /v1/onboarding — Lagre svar fra onboardingen (delvis er greit, «-» = hoppet over)

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `navn` | string |  |
| `telefon` | string |  |
| `epost` | string |  |
| `firma` | string |  |
| `bestemmer` | string | Hva brukeren bestemmer over |
| `paavirker` | string | Hva brukeren påvirker beslutninger om |

```bash
curl -X POST "https://firmasett.arnu.io/v1/onboarding" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"navn": "Kari Nordmann", "firma": "Eksempel AS", "bestemmer": "innkjøp av verktøy", "paavirker": "-"}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "fullfort": true,
    "mangler": [],
    "melding": "Takk, profilen er fullført.",
    "oppdatert": "2026-11-06T15:26:41",
    "profil": {
      "bestemmer": "innkjøp av verktøy",
      "epost": "kari@eksempel.no",
      "firma": "Eksempel AS",
      "navn": "Kari Nordmann",
      "paavirker": "-",
      "telefon": "90 •• •• ••"
    },
    "selskaper": 454566,
    "sporsmal": []
  },
  "meta": {
    "belastet": {},
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 0,
      "grense": 100,
      "igjen": 100
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


### GET /v1/bransjer — Næringskoder med antall og dekning, pluss fylker

```bash
curl "https://firmasett.arnu.io/v1/bransjer" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "bransjer": [
      {
        "antall": 101578,
        "bransje": "Eiendomsforvaltning på oppdrag",
        "kode": "68",
        "med_dl_epost": 18733,
        "med_dl_mobil": 26581
      },
      {
        "antall": 56277,
        "bransje": "Uoppgitt",
        "kode": "00",
        "med_dl_epost": 3568,
        "med_dl_mobil": 5972
      },
      {
        "antall": 28684,
        "bransje": "Annen detaljhandel med andre nye varer",
        "kode": "47",
        "med_dl_epost": 3762,
        "med_dl_mobil": 5603
      }
    ],
    "fylker": [
      "Agder",
      "Akershus",
      "Buskerud"
    ]
  },
  "meta": {
    "belastet": {},
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 0,
      "grense": 100,
      "igjen": 100
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


## selskaper


### GET /v1/selskaper/sok — Søk selskaper

Hvert treff som leveres teller som ett søketreff. Med antall_kun=ja får du bare totalen, gratis.

| Parameter | Type | Beskrivelse |
|---|---|---|
| `q` | string | Fritekst: firmanavn, daglig leder eller orgnr |
| `bransje` | string | Næringskode-prefiks, flere med komma (69.2,85.1) |
| `fylke` | string | Fylke(r), flere med komma |
| `kommune` | string | Kommune |
| `kundetype` | string | B2B | B2C | begge | offentlig |
| `ansatte_min` | number |  |
| `ansatte_maks` | number |  |
| `omsetning_min` | number | kr |
| `omsetning_maks` | number | kr |
| `stiftet_min` | integer | år |
| `stiftet_maks` | integer | år |
| `utestaende_min` | number | anslått utestående, kr |
| `utestaende_maks` | number |  |
| `kunder_min` | number | anslått antall kunder |
| `fakturaer_min` | number | anslått fakturaer per år |
| `kan_sms` | string | ja|nei – selskapet har mobilnummer |
| `har_dl_mobil` | string | ja|nei |
| `har_dl_epost` | string | ja|nei |
| `har_dl_linkedin` | string | ja|nei |
| `har_nettside` | string | ja|nei |
| `har_regnskap` | string | ja|nei |
| `status` | string | aktiv (standard) | konkurs | avvikling | tvangsavvikling | alle |
| `register` | string | 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. |
| `fakturerer_mange` | string | ja|nei – nettsida nevner purregebyr/inkasso/avtalegiro/efaktura |
| `kjede` | string | ja|nei |
| `konsern` | string | ja|nei |
| `signal` | string | delstreng i fakturasignaler: purregebyr, inkasso, avtalegiro, efaktura, ehf, abonnement |
| `regnskapsforer` | string | delstreng |
| `revisor` | string | delstreng |
| `regnskapssystem` | string | delstreng |
| `sorter` | string | omsetning | ansatte | utestaende | kunder | fakturaer | nyeste | navn |
| `antall` | integer | 1–100, standard 25 |
| `side` | integer | standard 1 |
| `antall_kun` | string | ja – bare tell treff. Gratis, teller ikke mot kvoten. |

```bash
curl "https://firmasett.arnu.io/v1/selskaper/sok?q=elektro&fylke=Rogaland&ansatte_min=10&har_dl_epost=ja&sorter=omsetning&antall=2" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "antall": 2,
    "side": 1,
    "total": 21,
    "treff": [
      {
        "ansatte": "191",
        "bransje": "Produksjon av batterier og akkumulatorer",
        "bransje_kode": "27.200",
        "daglig_leder": "Cheul Won Shin",
        "fylke": "Rogaland",
        "har_dl_epost": true,
        "har_dl_linkedin": false,
        "har_dl_mobil": false,
        "hjemmeside": "www.seam.no",
        "kan_sms": true,
        "kommune": "Karmøy",
        "kunder_anslag": 2277,
        "kundetype": "B2B",
        "navn": "Seam As",
        "omsetning": 683239234,
        "orgnr": "985947007",
        "stiftet": "2003-08-15",
        "utestaende_anslag": 105293718
      },
      {
        "ansatte": "199",
        "bransje": "Produksjon av elektriske fordelings- og kontrolltavler og paneler",
        "bransje_kode": "27.120",
        "daglig_leder": "Knut Husebø",
        "fylke": "Rogaland",
        "har_dl_epost": true,
        "har_dl_linkedin": false,
        "har_dl_mobil": false,
        "hjemmeside": "",
        "kan_sms": false,
        "kommune": "Stavanger",
        "kunder_anslag": 1639,
        "kundetype": "B2B",
        "navn": "Elcor As",
        "omsetning": 491793601,
        "orgnr": "957382800",
        "stiftet": "1990-01-03",
        "utestaende_anslag": 75790110
      }
    ]
  },
  "meta": {
    "belastet": {
      "sok": 2
    },
    "berikelser": {
      "brukt": 0,
      "grense": 1000,
      "igjen": 1000
    },
    "plan": "gratis",
    "sok": {
      "brukt": 2,
      "grense": 100,
      "igjen": 98
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```

Feil: 429 kvote_brukt (Retry-After i sekunder)


### GET /v1/selskaper/{orgnr} — Berik ett selskap

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.

| Parameter | Type | Beskrivelse |
|---|---|---|
| `orgnr` (påkrevd) | string |  |

```bash
curl "https://firmasett.arnu.io/v1/selskaper/810034882" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "anslag": {
      "betaling": "faktura",
      "dager_anslag": 25,
      "fakturaer_anslag": 753,
      "kunder_anslag": 251,
      "kundetype": "begge",
      "utestaende_anslag": 857983,
      "utestaende_kilde": "bransjeanslag"
    },
    "daglig_leder": {
      "andre_selskaper": "",
      "epost": "morten.aarrestad@sandneselektriske.no",
      "epost_alternativer": 0,
      "epost_grad": "E",
      "epost_kilde": "gjettet fra vanligste mønster",
      "epost_sikkerhet": "lav",
      "har_mobil": false,
      "kan_sms": false,
      "linkedin": "",
      "linkedin_grad": "",
      "linkedin_kilde": "",
      "mobil": "",
      "mobil_grad": "",
      "mobil_kilde": "",
      "navn": "Morten Aarrestad",
      "tittel": "Daglig leder"
    },
    "dekning": "full",
    "regnskap": {
      "aarsresultat": -78041,
      "aksjekapital": "2375000.0",
      "bank": "",
      "driftsresultat": -31910,
      "egenkapital": 1639483,
      "fordringer": "",
      "fordringer_andel": "",
      "kundefordringer": "",
      "lonn": "",
      "omsetning": 10021242,
      "regnskap_kilde": "eksport",
      "regnskapsaar": "2025"
    },
    "roller": {
      "daglig_leder": "Morten Aarrestad",
      "regnskapsforer": "ACCOUNT GROUP AS",
      "revisor": "ØKSENDAL REVISJON AS",
      "styreleder": "Jan Marton Aarrestad"
    },
    "selskap": {
      "adresse": "Strandgata 21",
      "ansatte": "11",
      "avdelinger": "3",
      "beskrivelse": "Enkelt, rimelig - alt elektrisk på samme sted",
      "bransje": "Elektrisk installasjonsarbeid",
      "bransje_kode": "43.210",
      "epost": "post@sandneselektriske.no",
      "formaal": "Drive handel, installasjons og servicevirksomhet, eller annen virksomhet forbundet med dette, samt delta i annen virksomhet.",
      "fylke": "Rogaland",
      "hjemmeside": "",
      "hjemmeside_kilde": "",
      "holding": "0",
      "kan_sms": 0,
      "kjede": "",
      "kjedesignal": "3 avdelinger",
      "kommune": "Sandnes",
      "konsern": "0",
      "linkedin_firma": "",
      "mobil": "",
      "morselskap": "",
      "mva": "1",
      "navn": "Sandnes Elektriske As",
      "orgform": "AS",
      "orgnr": "810034882",
      "poststed": "Sandnes",
      "status": "aktiv",
      "stiftet": "1977-06-15",
      "telefon": "51 •• •• ••",
      "telefon_type": "fast",
      "tidligere_navn": "SANDNES ELEKTRISKE FORRETNING AS"
    },
    "signaler": {
      "betalingsmaate_nettside": "",
      "fakturasignaler": "",
      "fakturerer_mange": 0,
      "inkassoselskap": "",
      "nettside_eposter_antall": 0,
      "regnskapssystem": ""
    }
  },
  "meta": {
    "belastet": {
      "berikelse": 1
    },
    "berikelser": {
      "brukt": 1,
      "grense": 1000,
      "igjen": 999
    },
    "plan": "gratis",
    "sok": {
      "brukt": 2,
      "grense": 100,
      "igjen": 98
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```

Feil: 429 kvote_brukt (Retry-After i sekunder)


### POST /v1/selskaper/berik — Berik inntil 100 selskaper

Én berikelse per selskap som finnes. resultat: {antall, funnet, resultater: [{orgnr, status, …Selskap}]}

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `orgnrs` (påkrevd) | array<string> | Maks 100. |

```bash
curl -X POST "https://firmasett.arnu.io/v1/selskaper/berik" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"orgnrs": ["810034882", "810059672"]}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "antall": 2,
    "bare_register": 0,
    "funnet": 2,
    "resultater": [
      {
        "anslag": {
          "betaling": "faktura",
          "dager_anslag": 25,
          "fakturaer_anslag": 753,
          "kunder_anslag": 251,
          "kundetype": "begge",
          "utestaende_anslag": 857983,
          "utestaende_kilde": "bransjeanslag"
        },
        "daglig_leder": {
          "andre_selskaper": "",
          "epost": "morten.aarrestad@sandneselektriske.no",
          "epost_alternativer": 0,
          "epost_grad": "E",
          "epost_kilde": "gjettet fra vanligste mønster",
          "epost_sikkerhet": "lav",
          "har_mobil": false,
          "kan_sms": false,
          "linkedin": "",
          "linkedin_grad": "",
          "linkedin_kilde": "",
          "mobil": "",
          "mobil_grad": "",
          "mobil_kilde": "",
          "navn": "Morten Aarrestad",
          "tittel": "Daglig leder"
        },
        "dekning": "full",
        "orgnr": "810034882",
        "regnskap": {
          "aarsresultat": -78041,
          "aksjekapital": "2375000.0",
          "bank": "",
          "driftsresultat": -31910,
          "egenkapital": 1639483,
          "fordringer": "",
          "fordringer_andel": "",
          "kundefordringer": "",
          "lonn": "",
          "omsetning": 10021242,
          "regnskap_kilde": "eksport",
          "regnskapsaar": "2025"
        },
        "roller": {
          "daglig_leder": "Morten Aarrestad",
          "regnskapsforer": "ACCOUNT GROUP AS",
          "revisor": "ØKSENDAL REVISJON AS",
          "styreleder": "Jan Marton Aarrestad"
        },
        "selskap": {
          "adresse": "Strandgata 21",
          "ansatte": "11",
          "avdelinger": "3",
          "beskrivelse": "Enkelt, rimelig - alt elektrisk på samme sted",
          "bransje": "Elektrisk installasjonsarbeid",
          "bransje_kode": "43.210",
          "epost": "post@sandneselektriske.no",
          "formaal": "Drive handel, installasjons og servicevirksomhet, eller annen virksomhet forbundet med dette, samt delta i annen virksomhet.",
          "fylke": "Rogaland",
          "hjemmeside": "",
          "hjemmeside_kilde": "",
          "holding": "0",
          "kan_sms": 0,
          "kjede": "",
          "kjedesignal": "3 avdelinger",
          "kommune": "Sandnes",
          "konsern": "0",
          "linkedin_firma": "",
          "mobil": "",
          "morselskap": "",
          "mva": "1",
          "navn": "Sandnes Elektriske As",
          "orgform": "AS",
          "orgnr": "810034882",
          "poststed": "Sandnes",
          "status": "aktiv",
          "stiftet": "1977-06-15",
          "telefon": "51 •• •• ••",
          "telefon_type": "fast",
          "tidligere_navn": "SANDNES ELEKTRISKE FORRETNING AS"
        },
        "signaler": {
          "betalingsmaate_nettside": "",
          "fakturasignaler": "",
          "fakturerer_mange": 0,
          "inkassoselskap": "",
          "nettside_eposter_antall": 0,
          "regnskapssystem": ""
        },
        "status": "ok"
      },
      {
        "anslag": {
          "betaling": "faktura",
          "dager_anslag": 15,
          "fakturaer_anslag": 228,
          "kunder_anslag": 19,
          "kundetype": "begge",
          "utestaende_anslag": 93515,
          "utestaende_kilde": "bransjeanslag"
        },
        "daglig_leder": {
          "andre_selskaper": "Nesset Historielag",
          "epost": "",
          "epost_alternativer": 0,
          "epost_grad": "",
          "epost_kilde": "",
          "epost_sikkerhet": "",
          "har_mobil": false,
          "kan_sms": false,
          "linkedin": "",
          "linkedin_grad": "",
          "linkedin_kilde": "",
          "mobil": "",
          "mobil_grad": "",
          "mobil_kilde": "",
          "navn": "Svein Olav Farstad",
          "tittel": "Daglig leder"
        },
        "dekning": "full",
        "orgnr": "810059672",
        "regnskap": {
          "aarsresultat": 1294114,
          "aksjekapital": "100000.0",
          "bank": "",
          "driftsresultat": 1734924,
          "egenkapital": 5386332,
          "fordringer": "",
          "fordringer_andel": "",
          "kundefordringer": "",
          "lonn": "",
          "omsetning": 2275533,
          "regnskap_kilde": "eksport",
          "regnskapsaar": "2024"
        },
        "roller": {
          "daglig_leder": "Svein Olav Farstad",
          "regnskapsforer": "REGNSKAPSKONTORET TOVE HUNDSETH",
          "revisor": "",
          "styreleder": "Svein Olav Farstad"
        },
        "selskap": {
          "adresse": "Sjøgardsvegen 8",
          "ansatte": "0",
          "avdelinger": "1",
          "beskrivelse": "",
          "bransje": "Utleie av egen eller leid fast eiendom",
          "bransje_kode": "68.200",
          "epost": "",
          "formaal": "Utleievirksomhet, fortrinnsvis av forretnings- eiendommer.",
          "fylke": "Møre og Romsdal",
          "hjemmeside": "",
          "hjemmeside_kilde": "",
          "holding": "0",
          "kan_sms": 1,
          "kjede": "",
          "kjedesignal": "",
          "kommune": "Molde",
          "konsern": "0",
          "linkedin_firma": "",
          "mobil": "41 •• •• ••",
          "morselskap": "",
          "mva": "0",
          "navn": "Aasen & Farstad As",
          "orgform": "AS",
          "orgnr": "810059672",
          "poststed": "Eidsvåg I Romsdal",
          "status": "aktiv",
          "stiftet": "1965-06-26",
          "telefon": "71 •• •• ••",
          "telefon_type": "fast",
          "tidligere_navn": ""
        },
        "signaler": {
          "betalingsmaate_nettside": "",
          "fakturasignaler": "",
          "fakturerer_mange": 0,
          "inkassoselskap": "",
          "nettside_eposter_antall": 0,
          "regnskapssystem": ""
        },
        "status": "ok"
      }
    ]
  },
  "meta": {
    "belastet": {
      "berikelse": 2
    },
    "berikelser": {
      "brukt": 3,
      "grense": 1000,
      "igjen": 997
    },
    "plan": "gratis",
    "sok": {
      "brukt": 2,
      "grense": 100,
      "igjen": 98
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


## personer


### GET /v1/personer/sok — Søk daglige ledere

| Parameter | Type | Beskrivelse |
|---|---|---|
| `q` | string | Fritekst: firmanavn, daglig leder eller orgnr |
| `bransje` | string | Næringskode-prefiks, flere med komma (69.2,85.1) |
| `fylke` | string | Fylke(r), flere med komma |
| `kommune` | string | Kommune |
| `kundetype` | string | B2B | B2C | begge | offentlig |
| `ansatte_min` | number |  |
| `ansatte_maks` | number |  |
| `omsetning_min` | number | kr |
| `omsetning_maks` | number | kr |
| `stiftet_min` | integer | år |
| `stiftet_maks` | integer | år |
| `utestaende_min` | number | anslått utestående, kr |
| `utestaende_maks` | number |  |
| `kunder_min` | number | anslått antall kunder |
| `fakturaer_min` | number | anslått fakturaer per år |
| `kan_sms` | string | ja|nei – selskapet har mobilnummer |
| `har_dl_mobil` | string | ja|nei |
| `har_dl_epost` | string | ja|nei |
| `har_dl_linkedin` | string | ja|nei |
| `har_nettside` | string | ja|nei |
| `har_regnskap` | string | ja|nei |
| `status` | string | aktiv (standard) | konkurs | avvikling | tvangsavvikling | alle |
| `register` | string | 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. |
| `fakturerer_mange` | string | ja|nei – nettsida nevner purregebyr/inkasso/avtalegiro/efaktura |
| `kjede` | string | ja|nei |
| `konsern` | string | ja|nei |
| `signal` | string | delstreng i fakturasignaler: purregebyr, inkasso, avtalegiro, efaktura, ehf, abonnement |
| `regnskapsforer` | string | delstreng |
| `revisor` | string | delstreng |
| `regnskapssystem` | string | delstreng |
| `sorter` | string | omsetning | ansatte | utestaende | kunder | fakturaer | nyeste | navn |
| `antall` | integer | 1–100, standard 25 |
| `side` | integer | standard 1 |
| `antall_kun` | string | ja – bare tell treff. Gratis, teller ikke mot kvoten. |

```bash
curl "https://firmasett.arnu.io/v1/personer/sok?bransje=43.21&fylke=Rogaland&har_mobil=ja&antall=2" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "antall": 2,
    "side": 1,
    "total": 209,
    "treff": [
      {
        "ansatte": "332",
        "bransje": "Elektrisk installasjonsarbeid",
        "firma": "Helgevold As",
        "fylke": "Rogaland",
        "har_epost": true,
        "har_linkedin": false,
        "har_mobil": true,
        "kommune": "Vindafjord",
        "navn": "Filippo Ballarin",
        "orgnr": "986389180",
        "tittel": "Daglig leder"
      },
      {
        "ansatte": "253",
        "bransje": "Elektrisk installasjonsarbeid",
        "firma": "Rønning Elektro As",
        "fylke": "Rogaland",
        "har_epost": false,
        "har_linkedin": false,
        "har_mobil": false,
        "kommune": "Stavanger",
        "navn": "Bård Skavland",
        "orgnr": "915581714",
        "tittel": "Daglig leder"
      }
    ]
  },
  "meta": {
    "belastet": {
      "sok": 2
    },
    "berikelser": {
      "brukt": 3,
      "grense": 1000,
      "igjen": 997
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


### POST /v1/berik/person — Berik en person (daglig leder)

Gi orgnr, eller navn + firma/domene. 1 berikelse ved treff. resultat = DagligLeder + orgnr, firma, bransje, fylke, hjemmeside.

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `orgnr` | string |  |
| `navn` | string |  |
| `firma` | string |  |
| `domene` | string |  |

```bash
curl -X POST "https://firmasett.arnu.io/v1/berik/person" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"orgnr": "810034882"}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "andre_selskaper": "",
    "bransje": "Elektrisk installasjonsarbeid",
    "epost": "morten.aarrestad@sandneselektriske.no",
    "epost_alternativer": 0,
    "epost_grad": "E",
    "epost_kilde": "gjettet fra vanligste mønster",
    "epost_sikkerhet": "lav",
    "firma": "Sandnes Elektriske As",
    "fylke": "Rogaland",
    "har_mobil": false,
    "hjemmeside": "",
    "kan_sms": false,
    "linkedin": "",
    "linkedin_grad": "",
    "linkedin_kilde": "",
    "mobil": "",
    "mobil_grad": "",
    "mobil_kilde": "",
    "navn": "Morten Aarrestad",
    "orgnr": "810034882",
    "tittel": "Daglig leder"
  },
  "meta": {
    "belastet": {
      "berikelse": 1
    },
    "berikelser": {
      "brukt": 4,
      "grense": 1000,
      "igjen": 996
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 5,
    "vindu": "totalt"
  }
}
```


## epost


### POST /v1/epost/finn — Finn e-post for navn på domene

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.

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `fornavn` | string |  |
| `etternavn` | string |  |
| `navn` | string |  |
| `domene` | string |  |
| `orgnr` | string |  |
| `firma` | string |  |

```bash
curl -X POST "https://firmasett.arnu.io/v1/epost/finn" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"fornavn": "Kari", "etternavn": "Nordmann", "domene": "sandneselektriske.no"}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "alternativer": [
      "kari@sandneselektriske.no",
      "k.nordmann@sandneselektriske.no",
      "knordmann@sandneselektriske.no"
    ],
    "domene": "sandneselektriske.no",
    "epost": "kari.nordmann@sandneselektriske.no",
    "firma": "Sandnes Elektriske As",
    "grad": "D",
    "kilde": "vanligste norske mønster, ikke bekreftet",
    "orgnr": "810034882",
    "sikkerhet": "lav"
  },
  "meta": {
    "belastet": {
      "berikelse": 1
    },
    "berikelser": {
      "brukt": 5,
      "grense": 1000,
      "igjen": 995
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 4,
    "vindu": "totalt"
  }
}
```


### POST /v1/epost/valider — Valider inntil 100 e-postadresser

Per adresse: syntaks, domene_svarer (MX/A), rolleadresse, fridomene, engangsdomene, kjent_i_datasettet, vurdering, grad. 1 berikelse per adresse.

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `eposter` | array<string> | Maks 100. |
| `epost` | string |  |

```bash
curl -X POST "https://firmasett.arnu.io/v1/epost/valider" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"eposter": ["morten.aarrestad@sandneselektriske.no", "post@finnes-ikke-123.no"]}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "antall": 2,
    "resultater": [
      {
        "domene": "sandneselektriske.no",
        "domene_svarer": true,
        "engangsdomene": false,
        "epost": "morten.aarrestad@sandneselektriske.no",
        "fridomene": false,
        "grad": "A",
        "kjent_i_datasettet": {
          "firma": "Sandnes Elektriske As",
          "orgnr": "810034882"
        },
        "rolleadresse": false,
        "syntaks": true,
        "vurdering": "gyldig (kjent)"
      },
      {
        "domene": "finnes-ikke-123.no",
        "domene_svarer": false,
        "engangsdomene": false,
        "epost": "post@finnes-ikke-123.no",
        "fridomene": false,
        "grad": "E",
        "kjent_i_datasettet": null,
        "rolleadresse": true,
        "syntaks": true,
        "vurdering": "ugyldig"
      }
    ]
  },
  "meta": {
    "belastet": {
      "berikelse": 2
    },
    "berikelser": {
      "brukt": 7,
      "grense": 1000,
      "igjen": 993
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 4,
    "vindu": "totalt"
  }
}
```


### GET /v1/epost/omvendt — Omvendt oppslag på e-post eller domene

resultat = Selskap + treff (daglig leders adresse | selskapets domene). 1 berikelse ved treff.

| Parameter | Type | Beskrivelse |
|---|---|---|
| `epost` | string |  |
| `domene` | string |  |

```bash
curl "https://firmasett.arnu.io/v1/epost/omvendt?domene=sandneselektriske.no" \
  -H "Authorization: Bearer fs_…"
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "anslag": {
      "betaling": "faktura",
      "dager_anslag": 25,
      "fakturaer_anslag": 753,
      "kunder_anslag": 251,
      "kundetype": "begge",
      "utestaende_anslag": 857983,
      "utestaende_kilde": "bransjeanslag"
    },
    "daglig_leder": {
      "andre_selskaper": "",
      "epost": "morten.aarrestad@sandneselektriske.no",
      "epost_alternativer": 0,
      "epost_grad": "E",
      "epost_kilde": "gjettet fra vanligste mønster",
      "epost_sikkerhet": "lav",
      "har_mobil": false,
      "kan_sms": false,
      "linkedin": "",
      "linkedin_grad": "",
      "linkedin_kilde": "",
      "mobil": "",
      "mobil_grad": "",
      "mobil_kilde": "",
      "navn": "Morten Aarrestad",
      "tittel": "Daglig leder"
    },
    "dekning": "full",
    "regnskap": {
      "aarsresultat": -78041,
      "aksjekapital": "2375000.0",
      "bank": "",
      "driftsresultat": -31910,
      "egenkapital": 1639483,
      "fordringer": "",
      "fordringer_andel": "",
      "kundefordringer": "",
      "lonn": "",
      "omsetning": 10021242,
      "regnskap_kilde": "eksport",
      "regnskapsaar": "2025"
    },
    "roller": {
      "daglig_leder": "Morten Aarrestad",
      "regnskapsforer": "ACCOUNT GROUP AS",
      "revisor": "ØKSENDAL REVISJON AS",
      "styreleder": "Jan Marton Aarrestad"
    },
    "selskap": {
      "adresse": "Strandgata 21",
      "ansatte": "11",
      "avdelinger": "3",
      "beskrivelse": "Enkelt, rimelig - alt elektrisk på samme sted",
      "bransje": "Elektrisk installasjonsarbeid",
      "bransje_kode": "43.210",
      "epost": "post@sandneselektriske.no",
      "formaal": "Drive handel, installasjons og servicevirksomhet, eller annen virksomhet forbundet med dette, samt delta i annen virksomhet.",
      "fylke": "Rogaland",
      "hjemmeside": "",
      "hjemmeside_kilde": "",
      "holding": "0",
      "kan_sms": 0,
      "kjede": "",
      "kjedesignal": "3 avdelinger",
      "kommune": "Sandnes",
      "konsern": "0",
      "linkedin_firma": "",
      "mobil": "",
      "morselskap": "",
      "mva": "1",
      "navn": "Sandnes Elektriske As",
      "orgform": "AS",
      "orgnr": "810034882",
      "poststed": "Sandnes",
      "status": "aktiv",
      "stiftet": "1977-06-15",
      "telefon": "51 •• •• ••",
      "telefon_type": "fast",
      "tidligere_navn": "SANDNES ELEKTRISKE FORRETNING AS"
    },
    "signaler": {
      "betalingsmaate_nettside": "",
      "fakturasignaler": "",
      "fakturerer_mange": 0,
      "inkassoselskap": "",
      "nettside_eposter_antall": 0,
      "regnskapssystem": ""
    },
    "treff": "domene"
  },
  "meta": {
    "belastet": {
      "berikelse": 1
    },
    "berikelser": {
      "brukt": 8,
      "grense": 1000,
      "igjen": 992
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 4,
    "vindu": "totalt"
  }
}
```


## telefon


### POST /v1/telefon/finn — Mobilnummer til daglig leder

1 telefonpoeng per nummer levert; ikke_funnet koster ingenting. resultat: {orgnr, firma, navn, mobil, kilde, grad, sikkerhet, kan_sms, alternativer, merk}

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `orgnr` | string |  |
| `firma` | string |  |
| `domene` | string |  |

```bash
curl -X POST "https://firmasett.arnu.io/v1/telefon/finn" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"orgnr": "923609016"}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "alternativer": 0,
    "firma": "Equinor Asa",
    "grad": "C",
    "kan_sms": true,
    "kilde": "annet selskap, rolle: Oslo Energy Forum Sti",
    "merk": "SMS til mobil krever samtykke etter markedsføringsloven § 15 når mottakeren er en fysisk person. Å ringe er lov.",
    "mobil": "90 •• •• ••",
    "navn": "Anders Opedal",
    "orgnr": "923609016",
    "sikkerhet": "middels"
  },
  "meta": {
    "belastet": {
      "telefon": 1
    },
    "berikelser": {
      "brukt": 4,
      "grense": 1000,
      "igjen": 996
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 4,
    "vindu": "totalt"
  }
}
```

Feil: 403 Ingen telefonpoeng


## sjekk


### POST /v1/sjekk — Sjekk egne kontakter mot Firmasett

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).

Kropp (JSON):

| Felt | Type | Beskrivelse |
|---|---|---|
| `rader` (påkrevd) | array<object> | Maks 100. |
| `rader[].id` | string |  |
| `rader[].orgnr` | string |  |
| `rader[].firma` | string |  |
| `rader[].domene` | string |  |
| `rader[].navn` | string |  |
| `rader[].epost` | string |  |
| `rader[].telefon` | string |  |
| `rader[].linkedin` | string |  |
| `rader[].tittel` | string |  |

```bash
curl -X POST "https://firmasett.arnu.io/v1/sjekk" \
  -H "Authorization: Bearer fs_…" \
  -H "Content-Type: application/json" \
  -d '{"rader": [{"id": "crm-17", "orgnr": "810034882", "navn": "Morten Aarrestad", "epost": "m.aarrestad@sandneselektriske.no", "telefon": ""}]}'
```

Svar (HTTP 200):

```json
{
  "status": "ok",
  "resultat": {
    "antall": 1,
    "resultater": [
      {
        "ansatte": "11",
        "beste_epost": "morten.aarrestad@sandneselektriske.no",
        "beste_epost_grad": "E",
        "bransje": "Elektrisk installasjonsarbeid",
        "daglig_leder": "Morten Aarrestad",
        "epost_status": "avviker",
        "firma": "Sandnes Elektriske As",
        "firma_epost": "post@sandneselektriske.no",
        "fylke": "Rogaland",
        "har_mobil": false,
        "hjemmeside": "",
        "id": "crm-17",
        "inn": {
          "epost": "m.aarrestad@sandneselektriske.no",
          "navn": "Morten Aarrestad",
          "orgnr": "810034882"
        },
        "kommune": "Sandnes",
        "kundetype": "begge",
        "mobil_grad": "",
        "omsetning": 10021242,
        "orgnr": "810034882",
        "sentralbord": "51685700",
        "telefon_status": "begge_mangler",
        "treff": "person"
      }
    ],
    "treff": 1
  },
  "meta": {
    "belastet": {
      "berikelse": 1
    },
    "berikelser": {
      "brukt": 9,
      "grense": 1000,
      "igjen": 991
    },
    "plan": "gratis",
    "sok": {
      "brukt": 4,
      "grense": 100,
      "igjen": 96
    },
    "telefonpoeng": 4,
    "vindu": "totalt"
  }
}
```

---
Kilde: https://firmasett.arnu.io/api-referanse · Firmasett, norsk B2B-data for folk og AI-agenter. Hele tjenesten: https://firmasett.arnu.io/llms.txt