# Firmasett API – referanse: Søk daglige ledere

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


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

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