Sign in

v61

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-018131,3812.6 MB
OpenMeter Customers

List credit grants

Pre-release Endpoint This endpoint is currently in beta and is subject to change.

List credit grants.

get/v3/openmeter/customers/{customerId}/credits/grants

Path parameters

customerIdstring required

ULID (Universally Unique Lexicographically Sortable Identifier).

Example:01G65Z755AFWAKHE12NY0CQ9FH

Query parameters

sizeinteger

The number of items to include per page.

numberinteger

The page number.

Determines which page of the collection to retrieve.

status'pending' | 'active' | 'expired' | 'voided'

Filter credit grants by status.

currencystring

Filter credit grants by currency.

Filter credit grants returned in the response.

{
  "currency": "USD"
}

Response

Page paginated response.

Example response

{
  "data": [
    {
      "id": "01G65Z755AFWAKHE12NY0CQ9FH",
      "labels": {
        "env": "test"
      },
      "created_at": "2023-01-01T01:01:01.001Z",
      "updated_at": "2023-01-01T01:01:01.001Z",
      "deleted_at": "2023-01-01T01:01:01.001Z",
      "currency": "USD",
      "purchase": {
        "currency": "USD"
      },
      "tax_config": {
        "tax_code": {
          "id": "01G65Z755AFWAKHE12NY0CQ9FH"
        }
      },
      "invoice": {
        "id": "01G65Z755AFWAKHE12NY0CQ9FH",
        "line": {
          "id": "01G65Z755AFWAKHE12NY0CQ9FH"
        }
      },
      "filters": {
        "features": [
          "input_tokens",
          "output_tokens"
        ]
      },
      "effective_at": "2023-01-01T01:01:01.001Z",
      "key": "019ae40f-4258-7f15-9491-842f42a7d6ac",
      "expires_at": "2023-01-01T01:01:01.001Z",
      "voided_at": "2023-01-01T01:01:01.001Z"
    }
  ],
  "meta": {
    "page": {
      "number": 1,
      "size": 10,
      "total": 100
    }
  }
}