Get Charge

Retrieves a charge by ID.

GET /v1/charges/:id

Request

Headers

Header	Required	Description
X-API-Key	Yes	Your API key

Path Parameters

Parameter	Type	Description
id	string	The charge ID

Example Request

curl https://api.bedrock.io/v1/charges/chrg_abc123def456 \
  -H "X-API-Key: sk_live_your_api_key"

Response

Success (200 OK)

{
  "id": "chrg_abc123def456",
  "orderId": "order-123",
  "amount": "25.00",
  "amountReceived": "25.00",
  "feeAmount": "0.25",
  "netAmount": "24.75",
  "currency": "USDC",
  "status": "COMPLETED",
  "cloneAddress": "0x1234567890abcdef1234567890abcdef12345678",
  "chainId": 8453,
  "paymentUrl": "https://pay.bedrock.io/chrg_abc123def456",
  "explorerUrl": "https://basescan.org/address/0x1234...",
  "feeBps": 100,
  "flushTxHash": "0xabcdef...",
  "expiresAt": "2024-01-15T12:30:00Z",
  "createdAt": "2024-01-15T12:00:00Z",
  "completedAt": "2024-01-15T12:15:00Z",
  "deployedAt": "2024-01-15T12:05:00Z"
}

Errors

Status	Code	Description
401	unauthorized	Invalid or missing API key
403	forbidden	Not authorized to view this charge
404	not_found	Charge not found

Get Charge by Order ID

You can also retrieve a charge using your order ID:

GET /v1/charges/order/:orderId

Example Request

curl https://api.bedrock.io/v1/charges/order/order-123 \
  -H "X-API-Key: sk_live_your_api_key"