Gebruik statistieken

Lees hoeveel credits een organisatie heeft verbruikt en inspecteer de onderliggende API-activiteit. Deze eindpunten gebruiken een Bearer JWT en vereisen de BILLING_ACCESS toestemming op de organisatie.

Data zijn in ISO 8601 (YYYY-MM-DD of volledige tijdstempels). Alle eindpunten worden aangesproken via organizationId; los het op vanuit Organisatie.

Kredietkosten

Data-dragende oproepen verbruiken credits van de maandelijkse toelage van de organisatie:

Oproep	Kredietkosten
Volledige dataset download (/files/:format)	10
Coördinaten (/coordinates)	15
Archief maand (/archives/:month/:format)	20
Listing, metadata, en gratis monsters	0

Voor het volledige krediet- en rate-limietmodel zie Rate limieten & credits.

Gebruik totalen

GET /v1/credits/:organizationId/api-usage?startDate=&endDate=

Geeft de totale oproepen en verbruikte credits terug over het datumbereik.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/credits/org_8f3a2c7e/api-usage?startDate=2026-05-01&endDate=2026-05-31"

{
  "organizationId": "org_8f3a2c7e",
  "startDate": "2026-05-01",
  "endDate": "2026-05-31",
  "totalCalls": 482,
  "creditsConsumed": 3120,
  "creditsRemaining": 6880
}

Veld	Beschrijving
totalCalls	Aantal API-oproepen in het bereik.
creditsConsumed	Credits uitgegeven in het bereik.
creditsRemaining	Credits over in de huidige toelage.

Gebruik per sleutel

GET /v1/credits/:organizationId/api-usage/by-key

Splitst dezelfde totalen per API-sleutel, zodat je de uitgaven aan een werklast kunt toeschrijven.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/credits/org_8f3a2c7e/api-usage/by-key"

{
  "organizationId": "org_8f3a2c7e",
  "keys": [
    {
      "apiKeyId": "key_9a2c7e8b",
      "name": "etl-nightly",
      "totalCalls": 410,
      "creditsConsumed": 2900
    },
    {
      "apiKeyId": "key_1d4056a1",
      "name": "ad-hoc-analyse",
      "totalCalls": 72,
      "creditsConsumed": 220
    }
  ]
}

Oproep log

GET /v1/credits/:organizationId/api-logs?page=&limit=&startDate=&endDate=&apiKeyId=&datasetId=

Geeft individuele API-oproepen terug, nieuwste eerst. Gebruik de filters om te verfijnen op datumbereik, sleutel of dataset.

Parameter	Type	Beschrijving
page	integer	1-gebaseerd paginanummer. Standaard 1.
limit	integer	Items per pagina. Maximum 100.
startDate	string	ISO 8601 begin van het bereik.
endDate	string	ISO 8601 einde van het bereik.
apiKeyId	string	Filter naar één sleutel.
datasetId	string	Filter naar één dataset.

curl -H "Authorization: Bearer eyJhbGci..." \
  "https://api.topolab.nl/v1/credits/org_8f3a2c7e/api-logs?page=1&limit=50&startDate=2026-05-01&endDate=2026-05-31&apiKeyId=key_9a2c7e8b"

{
  "data": [
    {
      "timestamp": "2026-05-28T02:14:11Z",
      "apiKeyId": "key_9a2c7e8b",
      "datasetId": "nl-domino-poi",
      "endpoint": "/v1/dataset/nl-domino-poi/files/geojson",
      "status": 200,
      "credits": 10
    }
  ],
  "page": 1,
  "limit": 50,
  "total": 410
}

Blader door de pagina's door page te verhogen totdat page * limit >= total.

Per-sleutel gebruik

Voor een enkele sleutel zonder de organisatie scope, gebruik het sleutel-niveau eindpunt gedocumenteerd in API-sleutels:

GET /v1/api-keys/:id/usage?startDate=&endDate=

Fouten

Status	Betekenis
401	Ontbrekende of ongeldige Bearer-token.
403	Je hebt geen BILLING_ACCESS op de organisatie.
404	De organisatie bestaat niet.
429	Rate gelimiteerd — zie Rate limieten & credits.

Volgende

• Facturen — factureringsdocumenten voor de organisatie.
• API-sleutels — gebruik toeschrijven aan individuele sleutels.
• Heb je een hogere toelage nodig? Neem contact met ons op.