# Kom igång på fem minuter

Skapa konto, hämta en testnyckel och gör ditt första anrop mot sandlådan med curl, JavaScript eller Python.

Källa: https://getapi.gradientvibe.se/docs

getBolag ger dina egna system svensk bolagsdata: bolag, styrelser, historik och bokslut. Du hämtar den via ett REST-API eller via MCP i AI-verktyg som Claude och Cursor. Datan levereras av Creditsafe i Sverige AB, och Bolagskällan AB är återförsäljare.

> **Live-data öppnas efter granskning.** Just nu fungerar testnycklar (`gb_test_…`) mot sandlådan, som har påhittade bolag. Live-nycklar svarar `blocked_by_phase` tills vi öppnar live-data. Allt du bygger mot sandlådan fungerar likadant mot live. Läs mer om [sandlådan](https://getapi.gradientvibe.se/docs/sandlada).

## 1. Skapa ett konto

[Skapa ett konto](https://getapi.gradientvibe.se/registrera) med ditt företags organisationsnummer och din jobbmejl. Bekräfta e-postadressen via länken vi skickar. Testnycklar fungerar direkt, även medan vi granskar kontot.

## 2. Skapa en testnyckel

Gå till [Konto → Nycklar](https://getapi.gradientvibe.se/konto) och välj **Skapa nyckel** med miljön **Test**. Nyckeln visas en gång. Spara den som en miljövariabel:

```bash
export GETBOLAG_KEY="gb_test_…"
```

## 3. Gör ditt första anrop

Hämta Exempelbolaget i Norrland AB, `569900-0013`, ur sandlådan:

curl:

```bash
curl -s "https://getapi.gradientvibe.se/api/v1/companies/569900-0013" \
  -H "Authorization: Bearer $GETBOLAG_KEY"
```

JavaScript:

```js
const res = await fetch('https://getapi.gradientvibe.se/api/v1/companies/569900-0013', {
  headers: { Authorization: `Bearer ${process.env.GETBOLAG_KEY}` },
})
const body = await res.json()
if (body.status !== 'ok') {
  throw new Error(`${body.error.code}: ${body.error.message}`)
}
console.log(body.data, body.meta.attribution)
```

Python:

```python
import os
import requests

res = requests.get(
    "https://getapi.gradientvibe.se/api/v1/companies/569900-0013",
    headers={"Authorization": f"Bearer {os.environ['GETBOLAG_KEY']}"},
    timeout=10,
)
body = res.json()
if body["status"] != "ok":
    raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
print(body["data"], body["meta"]["attribution"])
```

Svaret har alltid `status`, `data` och `meta`. I `meta` står bland annat vad anropet kostade (`cost_sek`), varifrån datan kommer (`attribution`) och ett `request_id` som du anger om du kontaktar oss. Sandlådan kostar ingenting.

Svar (HTTP 200):

```json
{
  "status": "ok",
  "data": {
    "org_number": "569900-0013",
    "name": "Exempelbolaget i Norrland AB",
    "legal_form": {
      "code": "AB",
      "text": "Aktiebolag"
    },
    "is_sole_trader": false,
    "status": {
      "active": true,
      "code": 100,
      "text": "Aktiv",
      "detailed": "Aktiv",
      "date": null
    },
    "registered_date": "2015-03-10",
    "deregistered_date": null,
    "dissolved_date": null,
    "seat": {
      "municipality": "Umeå",
      "region": "Västerbottens län"
    },
    "industry": {
      "sni_code": "62010",
      "text": "Dataprogrammering"
    }
  },
  "meta": {
    "request_id": "ad0a5836-28dc-4600-b112-ddf4808223c9",
    "source": [
      "sandbox"
    ],
    "attribution": [
      {
        "source": "getbolag-sandbox",
        "supplier": "getBolag",
        "notice": "Påhittad testdata. Inga riktiga bolag eller personer. Live-data levereras av Creditsafe i Sverige AB."
      }
    ],
    "retrieved_at": "2026-10-27T09:47:53.724Z",
    "data_updated_at": "2026-10-26T06:00:00Z",
    "cost_sek": 0,
    "environment": "test",
    "database": "getBolag (getbolag.se)",
    "publisher": "getBolag, ett varumärke i Bolagskällan AB (559555-5946)",
    "coverage": {
      "company": "available"
    }
  }
}
```

## 4. Nästa steg

- [REST-API](https://getapi.gradientvibe.se/docs/api): Alla endpoints med parametrar, svar och felkoder.
- [MCP](https://getapi.gradientvibe.se/docs/mcp): Anslut Claude, Claude Code eller Cursor till getBolag.
- [Svarsformat](https://getapi.gradientvibe.se/docs/svarsformat): status, data, meta, täckningsstatus och attribution.
- [Priser](https://getapi.gradientvibe.se/docs/priser): Pris per uppslag. Inte hittat debiteras inte.

OpenAPI-specifikationen finns på [https://getapi.gradientvibe.se/openapi.json](https://getapi.gradientvibe.se/openapi.json). Hela dokumentationen som text för AI-verktyg finns på [/llms-full.txt](https://getapi.gradientvibe.se/llms-full.txt).