Credit mutations

Changes in the credit of billing accounts

Endpoints
GET/credit_mutations

The credit mutation object

Attributes

iduuid

Unique identifier

billing_account_iduuid | null
billing_accounts.id

Identifier of the related billing account

organization_iduuid | null
organizations.id

Identifier of the related organization

paddle_transaction_idtext | null

Identifier of the Paddle transaction that bought the credit, if any

created_attimestamp with time zone

Creation timestamp

deltainteger

Change in credit: positive when credit is added, negative when it is used

Related resources

Embed related resources in the response with the select parameter, for example select=*,billing_accounts(*). See selecting data. Resources related through more than one column need the column as a hint, like table!column(*).

billing_accounts(*)object | null
billing_accounts.id

The billing account referenced by billing_account_id.

organizations(*)object | null
organizations.id

The organization referenced by organization_id.

The credit mutation object
JSON
{
  "id": "00000000-0000-0000-0000-000000000000",
  "billing_account_id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "paddle_transaction_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-01-01T12:00:00+00:00",
  "delta": 0
}
Including related resources
curl "https://api.cv-transformer.com/v1/credit_mutations?limit=10&select=*,billing_accounts(*),organizations(*)" \
  -H "Authorization: Bearer YOUR_API_KEY"

List credit mutations

Requiresorganization:read

Filters

idFilter<uuid>

Unique identifier

billing_account_idFilter<uuid | null>
billing_accounts.id

Identifier of the related billing account

organization_idFilter<uuid | null>
organizations.id

Identifier of the related organization

paddle_transaction_idFilter<text | null>

Identifier of the Paddle transaction that bought the credit, if any

created_atFilter<timestamp with time zone>

Creation timestamp

deltaFilter<integer>

Change in credit: positive when credit is added, negative when it is used

Responses

200

A list of credit mutations with the selected columns. The Content-Range header holds the range returned and the total count, like 0-9/42.

206

Partial Content

400

The request is malformed, for example an unknown column or an invalid filter.

401

The API key is missing or invalid.

403

The API key doesn't have the scope this request needs.

429

The API key made more requests per minute than its rate limit allows. Retry after the number of seconds in the Retry-After header.

Errors have a JSON body with a message, details and hint, and for database errors a code. See errors.
GET/credit_mutations
curl "https://api.cv-transformer.com/v1/credit_mutations?limit=10&select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"
Example response
JSON
[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "billing_account_id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "paddle_transaction_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-01-01T12:00:00+00:00",
    "delta": 0
  }
]