---
title: "Check API key status and usage"
method: GET
path: "/api/v0/stat"
tags: ["Usage"]
---

# Check API key status and usage

`GET /api/v0/stat`

## Request

- Base URL: `https://api.datalastic.com`
- URL: `https://api.datalastic.com/api/v0/stat`
- Auth: one of:
  - API key in header `x-api-key`
  - API key in query parameter `api-key`
- TypeScript: <https://skmtc.dev/datalastic/apis/datalastic-maritime-api/docs/api/v0/stat/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns your API key status and credit consumption for the current
billing period. Takes no parameters beyond authentication.

On unlimited plans `requests_remaining` reports a fixed placeholder
value and `requests_made` stays at `0`. Use the free `request_usage`
report to review historical consumption.

**Credit cost:** free. This endpoint does not deduct credits.

## Response `200`

API key status and credit usage.

- object
  - `data` Stat
    - `user_id` string: Your API key identifier.
    - `key_status` 'Valid' | 'Invalid': Key validity.
    - `requests_made` integer: Credits used in the current billing period. Stays at `0` on unlimited plans.
    - `requests_remaining` integer: Credits remaining in the current billing period. Reports a fixed placeholder value on unlimited plans. Use the free `request_usage` report to review historical consumption instead.
    - `addons` boolean: `true` if the Add-Ons package is active on this key.
  - `meta` Meta
    - `duration` number, float: Server-side query time in seconds.
    - `endpoint` string
    - `success` boolean
    - `next` string: Pagination token. Present on paginated endpoints (`/vessel_find`) only when more results exist. Pass it back as the `next` query parameter to fetch the following page.

## Other responses

- `400`: Missing required parameter or invalid parameter value.
- `401`: Invalid or expired API key.
- `402`: API key is valid but the credit balance is exhausted or the subscription has expired. Purchase more credits to continue.
- `404`: Requested vessel, port, or resource was not found. No credits deducted.
- `429`: More than 600 API calls in a single minute. The response carries a `Retry-After` header with the wait in seconds. Use it for backoff.
- `500`: Server-side error. Retry the request.

## Changes

- **2026-09-08** `a29cf323d1c3`: 7 warning, 12 info
  - deleted the `query` request parameter `api-key`
  - removed the optional property `data/api_key` from the response with the `200` status
  - removed the optional property `data/credits_remaining` from the response with the `200` status
  - removed the optional property `data/credits_total` from the response with the `200` status
  - …15 more

[Operation history](https://skmtc.dev/datalastic/apis/datalastic-maritime-api/changes/api/v0/stat/get.md)

---

[API](https://skmtc.dev/datalastic/apis/datalastic-maritime-api.md) - [All operations](https://skmtc.dev/datalastic/apis/datalastic-maritime-api/llms.txt) - [OpenAPI document](https://skmtc.dev/datalastic/apis/datalastic-maritime-api/revisions/2097cdbffcb4?raw)