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

# API Reference Overview

> An introduction to the CDR.fyi API reference documentation

Welcome to the CDR.fyi API reference documentation. This section provides detailed information about our API endpoints, including request and response formats, example code snippets, and error handling.

## Base URL

All API endpoints are relative to the following base URL:

`https://api.cdr.fyi/v1`

## Authentication

All API requests must be authenticated with a bearer token. Refer to the [Authentication](/authentication) section for details on how to obtain and use access tokens.

## Request Format

Unless otherwise specified, all API requests should be made with the `Content-Type` header set to `application/json`.

```bash theme={null}
curl -H "Content-Type: application/json" -H "Authorization: Bearer YOUR_ACCESS_TOKEN" https://api.cdr.fyi/v1/endpoint
```

## Response Format

API responses are returned in JSON format. Successful responses will have a 2xx status code, while errors will have a 4xx or 5xx status code.

### Example of a Successful Response

```json theme={null}
{
  "data": {
    "id": "abc123",
    "name": "Example Resource"
  }
}
```

### Example of an Error Response

```json theme={null}
{
  "error": {
    "code": 404,
    "message": "Resource not found"
  }
}
```

## Pagination

Some API endpoints support pagination. Refer to the Custom Headers section for details on how to use pagination headers.

## API Endpoints

* Orders
* Suppliers
* Marketplaces
* Purchasers
* Projects (Beta)