---
title: "Get an AI credit limit by customer and month"
method: GET
path: "/v1/ai-credit-limit/by-customer-month"
tags: ["ai-credit-limit"]
---

# Get an AI credit limit by customer and month

`GET /v1/ai-credit-limit/by-customer-month`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/v1/ai-credit-limit/by-customer-month`
- Auth: none declared

## Query parameters

- `customerId` string, required
- `date` string, date, required

## Response `200`

successful operation

- AiCreditLimit
  - `id` string, required: globally unique id
  - `customerId` string, required: customer id this limit applies to
  - `month` string, required: month this limit applies to
  - `creditSoftLimit` integer, required: maximum number of credits included for the month
  - `overageRate` number, required: overage rate in cents per credit beyond the soft limit
  - `creditHardLimit` integer: hard cap on credit usage for the month; usage above this is rejected
  - `createId` string: created by user id
  - `createBehalfId` string: created on behalf of user id
  - `createAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `createAt` string: created timestamp
  - `updateId` string: last updated by user id
  - `updateBehalfId` string: last updated on behalf of user id
  - `updateAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `updateAt` string: last updated timestamp
  - `deleteId` string: deleted by user id
  - `deleteBehalfId` string: deleted on behalf of user id
  - `deleteAttribution` Attribution
    - `principalUserId` string
    - `agentUserIds` string[]
    - `eventId` string
    - `aiChatId` string
    - `aiToolUseId` string
    - `channel` 'WEB' | 'MOBILE' | 'SLACK' | 'TEAMS' | 'MCP'
  - `deleteAt` string: deleted timestamp

## Other responses

- `401`: not authorized
- `403`: permission denied
- `404`: not found

---

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