---
title: "Get Feature credits balance"
method: GET
path: "/accounts/{account_id}/features/{feature_id}"
tags: ["Entitlements"]
---

# Get Feature credits balance

`GET /accounts/{account_id}/features/{feature_id}`

## Request

- Base URL: `https://api.togai.com`
- URL: `https://api.togai.com/accounts/{account_id}/features/{feature_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/togaihq/apis/togai-apis/docs/accounts/:account_id/features/:feature_id/get.ts> (a function with typed inputs; its response is checked against the schema)

This API let’s you to get the feature credits balance

## Path parameters

- `account_id` string, required
- `feature_id` string, required

## Response `200`

Success response

- GetFeatureCreditsResponse: Get feature credits response
  - `accountId` string, required
  - `featureId` string, required
  - `granted` number, required
  - `balance` number, required
  - `overageLimit` number
  - `usedOverage` number, required

## Other responses

- `400`: Bad request. Please check the response message for failure details.
- `401`: Credential is not valid. Please check the response message for failure details.
- `403`: Credential does not have access to add a license entry.
- `422`: Unable to process the query parameters provided. Please check our docs for the api limits - https://togai.io/docs/limits.
- `429`: Request throttled. Please check the response message on the failure details.
- `default`: Error response

## Changes

- **2023-09-07** `cfabb13f9886`: 2 info
  - added the optional property `overageLimit` to the response with the `200` status
  - added the required property `usedOverage` to the response with the `200` status
- **2023-09-02** `6b13f6f47735`: 1 breaking, 1 warning
  - removed the required property `usedOverage` from the response with the `200` status
  - removed the optional property `overageLimit` from the response with the `200` status

[Operation history](https://skmtc.dev/togaihq/apis/togai-apis/changes/accounts/:account_id/features/:feature_id/get.md)

---

[API](https://skmtc.dev/togaihq/apis/togai-apis.md) - [All operations](https://skmtc.dev/togaihq/apis/togai-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/togaihq/apis/togai-apis/revisions/442f5d8f4aa0?raw)