---
title: "X collection coverage for one asset or company"
method: GET
path: "/v2/social/x/coverage"
tags: ["Social Community"]
---

# X collection coverage for one asset or company

`GET /v2/social/x/coverage`

## 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/social/x/coverage`
- Auth: HTTP bearer

Per-subject collection state from the indexer: not_monitored (no subject), pending (active, nothing collected yet), collected (success within twice the refresh interval), delayed (older success; cache usable up to 24h), budget_exhausted (daily credit cap reached; cache usable) or unavailable (provider permanent error). Private/no-store; shares the X feed read budget.

## Query parameters

- `asset` string
- `company` string

## Response `200`

Coverage state for the subject

- SocialXCoverage
  - `subject_id` string, required
  - `state` 'not_monitored' | 'pending' | 'collected' | 'delayed' | 'unavailable' | 'budget_exhausted', required
  - `active` boolean, required
  - `last_success_at_ms` string, nullable, required
  - `next_attempt_at_ms` string, nullable, required
  - `cache_usable` boolean, required
  - `last_outcome` string, nullable, required

## Other responses

- `400`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `401`: Stable machine-readable problem. HTTP 429 and 503 responses include retry and cache-validity fields plus Retry-After and X-Request-ID headers.
- `429`: 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)