Agent Number

GET /number

Look up your assigned number and subscription details

Description

Returns the phone number and subscription metadata for the wallet behind the bearer token. Useful for confirming which number a token is bound to (e.g. after a subscription renewal or token rotation).

Authentication

Bearer required. Send Authorization: Bearer <token>.

Code samples

Pick your runtime. Every sample is in the page source — switching tabs is for your eyes.

curl https://agentnumber.really.com/number \
  --header 'Authorization: Bearer <your-token>'

Responses

200 Subscription details.

{
  "number": "+15555550123",
  "sub_account_id": "sub_example_001",
  "plan": "yearly",
  "expires_at": "2027-04-30T18:24:01.000Z"
}

401 Missing, invalid, revoked, or expired bearer token. Recover via `/auth/nonce` + `/auth`.

{
  "error": "unauthorized",
  "message": "invalid, revoked, or expired token"
}