---
title: "Get an X402 session"
method: GET
path: "/x402/session/{id}"
---

# Get an X402 session

`GET /x402/session/{id}`

## Request

- Base URL: `https://api.hyperbrowser.ai`
- URL: `https://api.hyperbrowser.ai/x402/session/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/docs/x402/session/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the purchased session's status and original expiry without another payment. Authenticate with managementToken, not the browser token. Connection credentials are not reissued.

## Path parameters

- `id` string, uuid, required

## Response `200`

Success. No payment is required.

- X402SessionStatus
  - `id` string, uuid, required
  - `status` 'active' | 'closed' | 'error' | 'close-error', required
  - `startTime` integer, nullable, required: Session start timestamp in Unix milliseconds, when available.
  - `endTime` integer, nullable, required: Session end timestamp in Unix milliseconds, when available.
  - `timeoutMinutes` integer, required: Prepaid duration chosen at creation.
  - `expiresAt` string, date-time, required: Original purchased expiry, unchanged by status checks or an early stop.

## Other responses

- `400`: Invalid session ID.
- `401`: Missing, invalid, expired, or incorrectly scoped management token.
- `403`: The token authorizes a different session.
- `404`: Session not found for the token's session and team.
- `500`: Session lookup or stop failed.

## Changes

- **2026-10-07** `71c0e245abdf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/changes/x402/session/:id/get.md)

---

[API](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api.md) - [All operations](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hyperbrowser/apis/hyperbrowser-api/revisions/ef089024c533?raw)