---
title: "Track remaining credits"
method: GET
path: "/account/credits_remaining"
tags: ["Account Credits Remaining"]
---

# Track remaining credits

`GET /account/credits_remaining`

## Request

- Base URL: `https://app.cicerodata.com/v3.1`
- URL: `https://app.cicerodata.com/v3.1/account/credits_remaining`
- Auth: none required

You can programmatically check on your account with the credits_remaining and usage resources.

Use the account/credits_remaining resource to track how many credits are left in your account.

Cost: 0 credits

## Query parameters

- `format` 'json' | 'xml'
- `customer_id` string, password, required
- `key` string, password

## Headers

- `Accept` 'application/json' | '*/*', required
- `Content-Type` 'application/json' | 'application/xml', required

## Response `200`

Successful response

- object
  - `response` ResponseCredits
    - `errors` unknown[]: If the request encountered an error or errors, details about the error(s) will be contained in this field.
      - unknown
    - `messages` unknown[]: Contains the resources matching the request query, if any.
      - unknown
    - `results` object: Contains additional information about the outcome of a request that is not an error and not part of a query result.
      - `credit_balance` number
      - `overdraft_limit` number
      - `usable_batches` object[]
        - `credits_purchased` number
        - `credits_remaining` number
        - `created` string
        - `expiration_time` string
        - `cost` string
        - `discount` string

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/melissa/apis/cicero.md) - [All operations](https://skmtc.dev/melissa/apis/cicero/llms.txt) - [OpenAPI document](https://skmtc.dev/melissa/apis/cicero/revisions/34d86f140b3f?raw)