Browse the docs

Get velocity control status

GET /v1/api-gateway/controls/velocity/{id}/status

Spend used in the current calendar month against the control's limit.

Request

Authentication: your API key in the x-api-key header.

Field	Type	Description
`id` required	string	Velocity control id.

cURL

curl --request GET \
     --url 'https://api.themooncard.com/v1/api-gateway/controls/velocity/{id}/status' \
     --header 'x-api-key: YOUR_API_KEY'

200 Success

Field	Type	Description
`used` required	number	Consumed so far in the current window: an amount in `currency` on a `SPEND` control, a count of approved authorizations on a `COUNT` one.
`limit` required	number	Limit for the window, in the same unit as `used`.
`velocity_control_id` required	string, nullable
`currency` required	string, nullable	ISO code `used` and `limit` are denominated in: the currency of the card's ledger account, which is what the authorization engine compares. Null on a `COUNT` control.

JSON

{
  "used": 124.5,
  "limit": 500,
  "velocity_control_id": "e2c4a6b8-0d1f-4a2b-8c3d-4e5f6a7b8c9d",
  "currency": "USD"
}

401 Error

Missing or invalid credentials, e.g. { "message": "Invalid API Key", "code": "UNAUTHORIZED" }.

The body is the standard error object: see Errors.

404 Error

Velocity control not found (VELOCITY_CONTROL_NOT_FOUND).

The body is the standard error object: see Errors.

500 Error

Unexpected server error. Body is { message: "Internal server error", code: "INTERNAL_SERVER_ERROR" }.

The body is the standard error object: see Errors.

Last updated August 16, 2026