# Firmasett API – referanse: Finn e-post for navn på domene

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

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