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

# API Reference

> Complete reference for the Orthogonal API

Base URL: `https://api.orthogonal.com`

## Authentication

All endpoints require an API key in the Authorization header:

```
Authorization: Bearer orth_live_xxxxxxxxxxxx
```

## Endpoints Overview

### Discovery API

Find and understand APIs programmatically.

| Method | Endpoint             | Description                       |
| ------ | -------------------- | --------------------------------- |
| POST   | `/v1/search`         | Search APIs with natural language |
| POST   | `/v1/details`        | Get endpoint parameters           |
| POST   | `/v1/integrate`      | Get code snippets                 |
| GET    | `/v1/list-endpoints` | List all available APIs           |

### Run API

Execute API calls.

| Method | Endpoint  | Description           |
| ------ | --------- | --------------------- |
| POST   | `/v1/run` | Call any API endpoint |

## Response Format

All responses follow this structure:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "requestId": "run_xxxxx"
}
```

Error responses:

```json theme={null}
{
  "success": false,
  "error": "Error message",
  "code": "ERROR_CODE"
}
```

## Error Codes

| Code                   | Description                 |
| ---------------------- | --------------------------- |
| `UNAUTHORIZED`         | Invalid or missing API key  |
| `INSUFFICIENT_CREDITS` | Account balance too low     |
| `RATE_LIMITED`         | Too many requests           |
| `NOT_FOUND`            | API or endpoint not found   |
| `UPSTREAM_ERROR`       | Error from the API provider |