---
title: "Get message-credit usage"
method: GET
path: "/v1/messages/credits"
tags: ["messages"]
---

# Get message-credit usage

`GET /v1/messages/credits`

## Query parameters

- `dropId` string

## Response `200`

Message-credit usage for the customer or requested drop.

- object
  - `creditsRemaining` integer, required — Message credits remaining in the current period.
  - `creditsUsed` integer, required — Message credits used in the current period.
  - `periodEndsAt` string, date-time, required — When the current usage period ends, in ISO 8601 with an explicit UTC offset.

## Other responses

- `400` — The request body is malformed.
- `401` — The integrator credential or customer API key is invalid.
- `403` — The customer account behind the API key has no paid Laylo plan.
- `404` — No route matches the requested path.
- `405` — The path exists, but the HTTP method is not supported.
- `409` — The request conflicts with the current resource state.
- `429` — The per-integrator rate limit for this operation is exceeded.
- `500` — An unexpected server error occurred.

---

[API](https://skmtc.dev/laylo/apis/laylo-api.md) · [All operations](https://skmtc.dev/laylo/apis/laylo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/laylo/laylo-api/revisions/000d81a01b74/schema)