# Firmasett API – referanse: Valider inntil 100 e-postadresser

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


## epost


### 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"
  }
}
```

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