Skip to main content
GET
/
api
/
v1
/
agents
/
charge
/
{id}
Retrieve Charge Details
curl --request GET \
  --url https://pulsarpay.io/api/v1/agents/charge/{id} \
  --header 'x-agent-key: <x-agent-key>'
{
  "id": "cmnf6jwup00091rcvo4qevr42",
  "idempotencyKey": "2207f602-c751-4b9b-98ae-456653bfe7b7",
  "amount": 50,
  "currency": "USDC",
  "description": "AI Inference Service",
  "status": "FAILED",
  "createdAt": "2026-03-31T22:20:03.217Z"
}

Headers

​
x-agent-key
string
required

The secret API key of the agent. This key ensures that only the agent who created the charge (or has administrative access) can view its details.

Path Parameters

​
id
string
required

The unique Cuids-based identifier for the charge. This is the chargeId returned during the creation process.

Response

Charge details retrieved successfully

​
id
string

Unique identifier for the charge record.

Example:

"cmnf6jwup00091rcvo4qevr42"

​
idempotencyKey
string

The unique string provided during creation to prevent duplicate processing.

Example:

"2207f602-c751-4b9b-98ae-456653bfe7b7"

​
amount
number

The transaction amount in decimal format (e.g., 50.00).

Example:

50

​
currency
enum<string>

The currency used for the transaction.

Available options:
USDC,
USD
Example:

"USDC"

​
description
string

The purpose of the charge as defined by the agent.

Example:

"AI Inference Service"

​
status
enum<string>

The current state of the charge in its lifecycle.

Available options:
PENDING,
SUCCESS,
FAILED,
EXPIRED
Example:

"FAILED"

​
createdAt
string<date-time>

Timestamp when the charge was first initialized.

Example:

"2026-03-31T22:20:03.217Z"