# Firmasett API – referanse: Søk selskaper

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


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

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