Skip to main content
GET
/
api
/
v1
/
x402
/
sessions
/
{id}
Get x402 Session
curl --request GET \
  --url https://api.agentwallex.com/api/v1/x402/sessions/{id} \
  --header 'X-API-Key: <api-key>'
{
  "id": "<string>",
  "agent_id": "<string>",
  "budget_limit": "<string>",
  "budget_spent": "<string>",
  "budget_remaining": "<string>",
  "chain": "<string>",
  "allowed_urls": [
    "<string>"
  ],
  "expires_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}

​
Path Parameters

​
id
string
required
The session ID (e.g., sess_xyz789).

​
Example

curl -X GET https://api.agentwallex.com/api/v1/x402/sessions/sess_xyz789 \
  -H "X-API-Key: awx_your_api_key"

Authorizations

​
X-API-Key
string
header
required

API key authentication. Keys are prefixed with awx_.

Path Parameters

​
id
string
required

The session ID (e.g., sess_xyz789).

Response

Session details.

An x402 payment session with a pre-authorized spending budget.

​
id
string

Unique session identifier (e.g., sess_xyz789).

​
agent_id
string

Agent whose wallet funds the session.

​
budget_limit
string

Maximum total amount the session can spend.

​
budget_spent
string

Total amount spent so far.

​
budget_remaining
string

Remaining budget available.

​
chain
string

CAIP-2 chain identifier for settlement.

​
status
enum<string>

Session status.

Available options:
active,
expired,
deleted
​
allowed_urls
string<uri>[]

URLs this session is authorized to pay.

​
expires_at
string<date-time>

ISO 8601 expiration timestamp.

​
created_at
string<date-time>

ISO 8601 creation timestamp.