---
title: "GET /v1/charges"
method: GET
path: "/v1/charges"
tags: ["charges"]
---

# GET /v1/charges

`GET /v1/charges`

## Request

- Base URL: `https://apibusiness-staging-civ.djamo.io`
- URL: `https://apibusiness-staging-civ.djamo.io/v1/charges`
- Auth: HTTP bearer

Limited to 30 requests per minute per company.

## Query parameters

- `limit` integer, required
- `cursor` string

## Response `200`

- ChargesList
  - `limit` number: Maximum number of charges per page
  - `cursor` object
    - `prev` string, nullable: Cursor of the previous page
    - `next` string, nullable: Cursor of the next page
  - `data` Charges[]
    - `id` string: The unique identifier of the charge.
    - `createdAt` string: Date and time when the charge was created. The API returns this value in ISO 8601 format.
    - `externalId` string: The unique identifier of the transaction on your side.
    - `description` string, required: Description of the charge
    - `currency` string: Currency of the charge
    - `amount` number, required: The amount to send to the account
    - `due` number: The amount due for the charge
    - `fees` object
      - `amount` number: The fee amount
      - `currency` string: Currency of the fee
      - `rate` number: The fee rate
      - `value` number: The fee value
    - `status` 'due' | 'paid' | 'canceled' | 'expired' | 'failed': Status of the charge
    - `droppedReason` string: The reason why the charge was dropped
    - `paid` number: The amount that has been paid
    - `refunded` number: The amount that has been refunded
    - `attempts` number: The number of attempts made to process the charge
    - `metadata` object: Additional information about the charge
    - `transactions` unknown[]: List of transactions related to the charge
      - unknown

## Other responses

- `400`
- `429`: Rate limit exceeded (TOO_MANY_ATTEMPTS)

## Changes

- **2026-11-18** `e7f36f4cab53`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/djamo/apis/djamo-business-api-playground/changes/v1/charges/get.md)

---

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