---
title: "List credit debits"
method: GET
path: "/credits/usage"
tags: ["Account"]
---

# List credit debits

`GET /credits/usage`

## Request

- Base URL: `https://api.emelia.io`
- URL: `https://api.emelia.io/credits/usage`
- Auth: API key in header `Authorization`

History of the credits really consumed (refunds and refunded debits are not listed), newest first. `page` is one based.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Success.

- object
  - `success` unknown
  - `items` object[]
    - `_id` string: MongoDB ObjectId: 24 hexadecimal characters.
    - `amount` number
    - `action` string: For example `email_finder`, `phone_finder`, `email_verification`, `phone_finder_bulk`, `scrap_phone_enrichment`.
    - `meta` object
    - `createdAt` string, date-time
  - `total` integer
  - `page` integer
  - `totalPages` integer

## Other responses

- `401`: Missing, malformed, unknown or disabled API key. The key must be exactly 48 characters, otherwise it is treated as a session token and rejected the same way.
- `500`: Unexpected error. IMPORTANT: this is also what you receive today when the per minute quota of your account is exceeded (the quota error is not mapped to 429 for API keys). No `Retry-After` header is sent. Wait until the next minute window before retrying.

---

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