---
title: "Credits left, free monthly credits and limits"
method: GET
path: "/credits"
---

# Credits left, free monthly credits and limits

`GET /credits`

## Request

- Base URL: `https://localscreenshot.com/v1`
- URL: `https://localscreenshot.com/v1/credits`
- Auth: HTTP bearer

## Response `200`

Credits.

- object
  - `credits` object
    - `remaining` integer
  - `free_monthly` object: The free credits of this account. An account without a monthly plan gets them each calendar month (UTC), the first time it is used that month. They do not carry over. After the month the account was created, its email address must be confirmed.
    - `credits` integer: Free credits given each month.
    - `remaining` integer: What is left of this month's free credits.
    - `eligible` boolean: Whether this account gets the free monthly credits.
    - `reason` 'plan' | 'unverified' | 'blocked' | 'withheld' | 'closed' | 'delayed' | 'pending' | 'null', nullable: Why not, when it does not: on a monthly plan, email address to confirm, screenshots blocked, first month withheld. "delayed": eligible, but this month's credits could not be given today and will be at the first use tomorrow. "pending": eligible, given at the next use of the account.
    - `renews_at` string, date-time, nullable: When the next free credits can arrive: the 1st of next month, 00:00 UTC (tomorrow, 00:00 UTC, when delayed; now, when pending). Null when none will.
  - `costs` object
  - `limits` object

## Other responses

- `default`: An error. "code" is stable; "retryable" says whether trying again as is can work.

---

[API](https://skmtc.dev/localscreenshot/apis/screenshot-api.md) · [All operations](https://skmtc.dev/localscreenshot/apis/screenshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/localscreenshot/apis/screenshot-api/revisions/6027b204b742?raw)