> ## 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 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.