# Takt och tak

Anrop per minut, sökkvot, tak på antal bolag per dygn, månadstak, dygnstak per nyckel och Idempotency-Key.

Källa: https://getapi.gradientvibe.se/docs/takt-och-tak

Gränserna skyddar dig mot oväntade kostnader, till exempel en AI-agent som fastnar i en loop, och tjänsten mot nedladdning av registret. De gäller både REST och MCP, och både live och test.

| Gräns | Värde | Fel |
| --- | --- | --- |
| Anrop per nyckel eller OAuth-anslutning | 120 per minut | `429 rate_limited` |
| Anrop per konto | 600 per minut | `429 rate_limited` |
| Sökningar per konto | 1 000 per dygn | `429 search_quota_exceeded` |
| Olika bolag och personer per konto | 2 000 per dygn som standard. Varje person vars engagemang du hämtar räknas som ett | `429 entity_cap_exceeded` |
| Kostnad per konto och månad (månadstak) | 1 000 kr som standard | `402 monthly_cap_reached` |
| Kostnad per nyckel och dygn | Valfritt, sätts per nyckel | `402 key_daily_cap_reached` |
| Saldo | Dina krediter | `402 insufficient_credits` |

## Anrop per minut

Takten räknas per kalenderminut. Svaret `429` har headern `Retry-After` med antal sekunder till nästa minut. Sprid ut anropen i stället för att skicka dem i skurar.

## Olika bolag per dygn

Vi räknar hur många olika bolag kontot hämtar per dygn. Samma bolag igen samma dygn räknas inte en gång till. Taket finns för att API:t är till för uppslag per företag och urval, inte för att kopiera registret. Behöver ni ett högre tak för ett avgränsat urval, kontakta support@getbolag.se.

## Månadstak och dygnstak per nyckel

Månadstaket stoppar alla betalda anrop när kontots förbrukning för kalendermånaden når taket. Ett dygnstak per nyckel stoppar bara den nyckeln. Båda kontrolleras innan uppslaget görs, så ett stoppat anrop kostar ingenting.

## Idempotency-Key

Agenter och nätverk gör om anrop. Skicka headern `Idempotency-Key` med ett unikt värde per uppslag, till exempel ett UUID, och använd samma värde när du försöker igen. Görs exakt samma anrop (samma operation och samma bolag) om med en nyckel vars första anrop lyckades, debiteras det inte igen. Du får svaret på nytt med `cost_sek: 0`.

```bash
curl -s "https://getapi.gradientvibe.se/api/v1/companies/569900-0013/roles" \
  -H "Authorization: Bearer $GETBOLAG_KEY" \
  -H "Idempotency-Key: 3f1c2a9e-7d4b-4c55-9a51-0b6f1f7f2d10"
```

Använd aldrig samma `Idempotency-Key` för två olika uppslag. Det andra anropet avvisas då med `422 idempotency_key_reused` och lämnar inte ut någon data. Ett anrop som slutade med fel eller inte hittat räknas inte som lyckat: görs det om och hittar något, debiteras det som vanligt.

## Vad ett dygn är

Dygns- och månadsgränser följer kalendern och nollställs vid midnatt respektive månadsskiftet.