List Charges

Returns a paginated list of charges for your merchant account.

GET /v1/charges

Request

Headers

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

Query Parameters

Parameter	Type	Default	Description
page	integer	1	Page number
limit	integer	20	Results per page (max 100)
status	string	-	Filter by status

Example Request

curl "https://api.bedrock.io/v1/charges?page=1&limit=10&status=COMPLETED" \
  -H "X-API-Key: sk_live_your_api_key"

Response

Success (200 OK)

{
  "data": [
    {
      "id": "chrg_abc123def456",
      "orderId": "order-123",
      "amount": "25.00",
      "amountReceived": "25.00",
      "feeAmount": "0.25",
      "netAmount": "24.75",
      "currency": "USDC",
      "status": "COMPLETED",
      "cloneAddress": "0x1234...",
      "chainId": 8453,
      "paymentUrl": "https://pay.bedrock.io/chrg_abc123def456",
      "explorerUrl": "https://basescan.org/address/0x1234...",
      "feeBps": 100,
      "flushTxHash": "0xabcd...",
      "expiresAt": "2024-01-15T12:30:00Z",
      "createdAt": "2024-01-15T12:00:00Z",
      "completedAt": "2024-01-15T12:15:00Z",
      "deployedAt": "2024-01-15T12:05:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 10,
    "total": 45,
    "pages": 5
  }
}

Filtering by Status

Available status values:

Status	Description
PENDING	Waiting for payment
RECEIVED	Payment received, settlement in progress
COMPLETED	Payment completed and settled
EXPIRED	Charge expired
CANCELLED	Charge cancelled

Example: Get Pending Charges

curl "https://api.bedrock.io/v1/charges?status=PENDING" \
  -H "X-API-Key: sk_live_your_api_key"