---
title: "GET /v1/credits"
method: GET
path: "/v1/credits"
---

# GET /v1/credits

`GET /v1/credits`

## Query parameters

- `by_api_key` string — If true, returns usage broken down by API key

## Response `200`

Success

- object
  - `remaining_credits` string, required
  - `credit_usage` string, required
  - `total_deposits` string, required
  - `usage_by_api_key` object[]
    - `api_key_id` string, required
    - `api_key_name` string, required
    - `credit_usage` string, required
    - `total_requests` number, required
    - `created_at` string, nullable, required
    - `is_active` boolean, required
    - `spend_limit` string, nullable, required
    - `spend_limit_period` 'day' | 'week' | 'month', nullable, required
    - `period_spend` string, required
    - `period_start` string, nullable, required
    - `expires_at` string, nullable, required

---

[API](https://skmtc.dev/imagerouter/apis/image-router-api.md) · [All operations](https://skmtc.dev/imagerouter/apis/image-router-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/imagerouter/image-router-api/revisions/716322e546d5/schema)