---
title: "Gets a charge by ID"
method: GET
path: "/charges/{id}"
tags: ["Charges"]
---

# Gets a charge by ID

`GET /charges/{id}`

Retrieves the details of a Charge by supplying its unique identifier.

## Path parameters

- `id` string, required

## Response `200`

OK.

- Charge
  - `id` string — The unique identifier of the charge.
  - `createdTime` string, date-time — The time when the charge was created.
  - `currency` string — A three-letter ISO 4217 currency code.
  - `amount` number, double — An amount representing how much is to be to charged.
  - `state` 'pending' | 'capturable' | 'processing' | 'complete' | 'cancelled' | 'failed' — The state of the charge.
  - `orderId` string — The identifier of the associated order.
  - `sourceId` string — The identifier of the source.
  - `failureCode` string — Error code identifying reason for charge failure.
  - `failureMessage` string — Error message describing reason for charge failure.
  - `paymentSessionId` string — Tracks the process of collecting a payment.
  - `cancels` Cancel[]
    - `id` string — The unique identifier of the cancel.
    - `createdTime` string, date-time — The time when the cancel was created.
    - `updatedTime` string, date-time — The time when the cancel was updated.
    - `amount` number, double — An amount representing how much was cancelled.
    - `state` 'pending' | 'pending_information' | 'complete' | 'failed' — The state of the cancel.
    - `failureCode` string — An error code that identifies the reason for the cancel failure.
    - `failureMessage` string — An error message that describes the reason for the cancel failure.
  - `captures` Capture[]
    - `id` string — The unique identifier of the capture.
    - `createdTime` string, date-time — The time when the capture was created.
    - `updatedTime` string, date-time — The time when the capture was updated.
    - `amount` number, double — An amount representing how much was captured.
    - `state` 'pending' | 'complete' | 'failed' — The state of the capture.
    - `failureCode` string — An error code that identifies the reason for the capture failure.
    - `failureMessage` string — An error message that describes the reason for the capture failure.
  - `captured` boolean — Indicates if the charge has been captured.
  - `refunds` Refund[]
    - `id` string — The unique identifier of the refund.
    - `createdTime` string, date-time — The time when the refund was created.
    - `updatedTime` string, date-time — The time when the refund was updated.
    - `amount` number, double — An amount representing how much was refunded.
    - `state` 'pending' | 'complete' | 'failed' — The state of the refund.
    - `failureCode` string — An error code that identifies the reason for the refund failure.
    - `failureMessage` string — An error message that describes the reason for the refund failure.
  - `refunded` boolean — Indicates if the charge has been refunded.
  - `type` 'customer_initiated' | 'merchant_initiated' | 'moto' — The type of charge.
  - `liveMode` boolean — Has the value <code>true</code> if the object exists in live mode and the value <code>false</code> if the object exists in test mode.

## Other responses

- `400` — 400 Bad Request
- `401` — 401 Unauthorized
- `403` — 403 Forbidden
- `404` — 404 Not Found
- `405` — 405 Method Not Allowed
- `406` — 406 Not Acceptable
- `408` — 408 Request Timeout
- `429` — 429 Too Many Requests
- `500` — 500 Internal Server Error
- `502` — 502 Bad Gateway Error
- `503` — 503 Service Unavailable Error
- `504` — 504 Gateway Timeout Error

---

[API](https://skmtc.net/digitalriver/apis/digital-river-api-reference.md) · [All operations](https://skmtc.net/digitalriver/apis/digital-river-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/digital-river-api-reference/revisions/f21981db32be/schema)