# Firmasett API – referanse: Sjekk egne kontakter mot Firmasett

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


## 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/sjekk · Firmasett, norsk B2B-data for folk og AI-agenter. Hele tjenesten: https://firmasett.arnu.io/llms.txt