---
title: "Get a charge"
method: GET
path: "/v1/charges/{id}"
tags: ["Charges"]
---

# Get a charge

`GET /v1/charges/{id}`

Retrieve details for a specific charge by ID.

## Path parameters

- `id` string, required

## Response `200`

Charge details

- object — Charge details
  - `id` string — Unique charge identifier
  - `customerId` string — Customer ID
  - `customer` object — Customer who was charged
    - `id` string
    - `onchainAddress` string — Smart account address
    - `externalCustomerId` string, nullable — Your system customer ID
  - `usageId` string — Associated usage event ID
  - `usageEvent` object — Usage event that triggered this charge
    - `id` string
    - `type` string — Usage type from pricing plan
    - `quantity` string — Quantity consumed
    - `metadata` object, nullable — Custom metadata attached to usage event
    - `createdAt` string, date-time
  - `amountUsdc` string — Amount charged in USDC
  - `amountToken` string — Amount in token units (6 decimals)
  - `txHash` string, nullable — On-chain transaction hash when confirmed
  - `blockNumber` string, nullable — Block number when charge was confirmed
  - `status` 'PENDING' | 'PENDING_SETTLEMENT' | 'CONFIRMED' | 'FAILED' | 'REFUNDED' | 'REFUND_PENDING' — Current charge status: PENDING (processing), PENDING_SETTLEMENT (in batch), CONFIRMED (settled), FAILED (error), REFUNDED (returned)
  - `failureReason` string, nullable — Error message if charge failed
  - `createdAt` string, date-time — When the charge was created
  - `confirmedAt` string, date-time, nullable — When the charge was confirmed on-chain

## Other responses

- `401` — Unauthorized
- `403` — Forbidden (secret key required)
- `404` — Charge not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)