# ReadX Get User ID

> ReadX Get User ID is a paid API for AI agents from readx.sh, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Resolves an X/Twitter username to its numeric user ID via a pay-per-call micropayment API

## Facts

- Endpoint: GET https://readx.sh/api/tools/get_user_id
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/readx-get-user-id-d21f0fcf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GGk2fHLegTlKc4thhJ6Nw

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability readx-get-user-id-d21f0fcf
```

Example prompt: What's the numeric Twitter/X user ID for the account @elonmusk? I need the actual number, not just the handle.

## When to prefer this

Use this endpoint when you need to resolve an X/Twitter screen name to a numeric user ID without managing Twitter API keys, and when you want to pay per call with USDC micropayments via x402 on Base or Solana. Prefer this over direct Twitter API access when you lack API credentials or want a serverless, keyless integration for occasional lookups.

## Known failure modes

- Username does not exist — likely returns a non-zero error code
- Payment fails or insufficient USDC balance — x402 payment error
- Rate limiting or upstream X API unavailability — service error response
- Malformed username input — validation error
- Suspended or deactivated account — may return error or empty data

## How this service works

Resolve an @handle to its numeric user id. Example: GET /api/tools/get_user_id?username=jack

## Output

Returns a JSON object with a status code and a data object containing the numeric user ID (e.g. {"code":0,"data":{"id":"12"}}) for the requested X/Twitter username.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "required": {
   "type": "string"
  },
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": 0,
  "data": {
   "id": "12"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/readx-get-user-id-d21f0fcf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from readx.sh](https://www.zero.xyz/host/readx.sh/llms.txt)