---
title: "GET /v2/me/x-discovery"
method: GET
path: "/v2/me/x-discovery"
tags: ["Social"]
---

# GET /v2/me/x-discovery

`GET /v2/me/x-discovery`

## Request

- Base URL: `https://api.arbital.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.arbital.xyz/v2/me/x-discovery`
- Auth: HTTP bearer

Returns the authenticated user's server-owned X discovery authorization state. Tokens are never returned.

## Response `200`

X identity and discovery authorization state

- XDiscoveryStatus
  - `granted_scopes` string[], nullable, required: Scopes returned by X for this stored authorization. A usable discovery authorization includes tweet.read, users.read, follows.read, and offline.access and excludes publishing scopes.
  - `state` 'unlinked' | 'identity_linked' | 'discovery_authorized' | 'reauthorization_required', required
  - `x_provider_user_id` string, nullable, required

## Other responses

- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `409`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `503`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.

---

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