---
title: "Status"
method: GET
path: "/status"
tags: ["Account"]
---

# Status

`GET /status`

## Request

- Base URL: `https://api.vesselfinder.com`
- URL: `https://api.vesselfinder.com/status`
- Auth: API key in query parameter `userkey`

Returns the remaining credits and the expiration date of your account. For VesselsList accounts also the state of the vessel list. Free of charge.

## Query parameters

- `format` 'json' | 'xml'
- `errormode` 409

## Response `200`

Account status.

- union
  - Status
    - `CREDITS` integer: Remaining credits.
    - `LIST_LIMIT` integer: VesselsList accounts only. Maximum number of vessels in your list (IMO and MMSI together).
    - `REMAINING_SLOTS` integer: VesselsList accounts only. Vessels you can still add to your list this month. Deleting does not free a slot.
    - `MMSI_LIST` integer: VesselsList accounts only. Number of MMSI in your list.
    - `IMO_LIST` integer: VesselsList accounts only. Number of IMO in your list.
    - `EXPIRATION_DATE` string: Account expiration date, UTC, `YYYY-MM-DD HH:MM:SS`.
  - Error: Returned with HTTP 200 (default error mode) when parameters are invalid, the account is expired or blocked, or credits are insufficient. In XML: `<error>ERROR DESCRIPTION</error>`.
    - `error` string, required

## Other responses

- `409`: Error, returned only when `errormode=409` is set.

---

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