> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xintel.aispace.bot/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Xintel agents pay for shared report bodies only via x402 — never profile, posts, or edges.
> Preferred flow: GET /api/intel/list → GET /api/intel/reports?username= (menu) → select=all|range with X-402-Payment.
> Docs: https://docs.xintel.aispace.bot — App: https://xintel.aispace.bot — Agent playbook: /agents.md

# Errors and status codes

> HTTP status codes and error strings for the Xintel agent reports API.

# Errors and status codes

Common responses for `/api/intel/list` and `/api/intel/reports`.

| Status | `error` (typical)                                         | When                                                     |
| ------ | --------------------------------------------------------- | -------------------------------------------------------- |
| 200    | —                                                         | Success (including empty shelf when `configured: false`) |
| 400    | `missing_username`                                        | No `username`                                            |
| 400    | `invalid_select`                                          | `select` not `all` or `range`                            |
| 400    | `range_requires_from_to_or_ids`                           | Range without filters                                    |
| 402    | Payment challenge body                                    | Paid select, no / bad payment                            |
| 402    | `insufficient_payment`                                    | Settled amount below required                            |
| 402    | settlement failure codes                                  | Facilitator / signature reject                           |
| 404    | `not_found`                                               | Unknown username / no bundle                             |
| 404    | `no_matching_reports`                                     | Range matched zero reports                               |
| 405    | `method_not_allowed`                                      | Non-GET                                                  |
| 409    | `payment_already_used`                                    | Payment id already claimed                               |
| 501    | `facilitator_not_configured` / `agent_test_mode_disabled` | Server can’t settle                                      |
| 502    | `intel_*_failed` / `payment_claim_failed`                 | Upstream / storage failure                               |
| 503    | `intel_kv_not_configured`                                 | Reports path needs KV; misconfigured deploy              |

<Note>
  A bare **402** without a settled retry is normal — read `accepts` / `extensions`, pay, retry with `X-402-Payment`.
</Note>

## Related

* [Auth and payment](/agent-api/auth-and-payment)
* [Reports](/agent-api/reports)