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

# API Reference

> Datagate REST API reference

## Base URL

```
https://api.getdatagate.com/v1/
```

## Authentication

All requests require an `Authorization` header:

```
Authorization: Bearer <api_key_or_jwt>
```

## Content Type

All request and response bodies are JSON:

```
Content-Type: application/json
```

## Common Endpoints

| Method   | Path                | Description               |
| -------- | ------------------- | ------------------------- |
| `GET`    | `/v1/users/me`      | Get profile               |
| `PUT`    | `/v1/users/me`      | Update profile            |
| `POST`   | `/v1/auth/api-keys` | Generate / rotate API key |
| `GET`    | `/v1/auth/api-keys` | Get current key suffix    |
| `DELETE` | `/v1/auth/api-keys` | Revoke API key            |

## Buyer Endpoints

| Method   | Path                             | Description                   |
| -------- | -------------------------------- | ----------------------------- |
| `GET`    | `/v1/datasets/discover`          | Discover all visible datasets |
| `GET`    | `/v1/datasets/subscribed`        | List subscribed datasets      |
| `GET`    | `/v1/datasets/{id}`              | Get dataset detail            |
| `POST`   | `/v1/marketplace/{id}/subscribe` | Subscribe to dataset          |
| `DELETE` | `/v1/marketplace/{id}/subscribe` | Unsubscribe from dataset      |
| `POST`   | `/v1/query`                      | Query across datasets         |
| `POST`   | `/v1/synthesize`                 | Query + LLM synthesis         |
| `GET`    | `/v1/billing/buyer-balance`      | Get balance                   |
| `POST`   | `/v1/billing/deposit`            | Create deposit checkout       |
| `GET`    | `/v1/billing/deposits`           | Deposit history               |
| `GET`    | `/v1/billing/auto-deposit`       | Auto-deposit config           |
| `PUT`    | `/v1/billing/auto-deposit`       | Configure auto-deposit        |
| `GET`    | `/v1/billing/payment-info`       | Saved payment methods         |
| `POST`   | `/v1/billing/portal`             | Stripe billing portal         |

## Seller Endpoints

| Method   | Path                            | Description               |
| -------- | ------------------------------- | ------------------------- |
| `POST`   | `/v1/connectors`                | Create connector          |
| `GET`    | `/v1/connectors`                | List connectors           |
| `GET`    | `/v1/connectors/{id}`           | Get connector detail      |
| `PUT`    | `/v1/connectors/{id}`           | Update connector          |
| `DELETE` | `/v1/connectors/{id}`           | Delete connector          |
| `POST`   | `/v1/datasets`                  | Create dataset            |
| `GET`    | `/v1/datasets`                  | List datasets             |
| `PUT`    | `/v1/datasets/{id}`             | Update dataset            |
| `POST`   | `/v1/datasets/{id}/access`      | Grant buyer access        |
| `DELETE` | `/v1/datasets/{id}/access`      | Revoke buyer access       |
| `GET`    | `/v1/datasets/{id}/buyers`      | List buyers who queried   |
| `GET`    | `/v1/royalties/me/datasets`     | Per-dataset earnings      |
| `GET`    | `/v1/royalties/me/earnings`     | Earnings time series      |
| `GET`    | `/v1/royalties/me/buyers`       | Per-buyer earnings        |
| `POST`   | `/v1/billing/connect`           | Stripe Connect onboarding |
| `GET`    | `/v1/billing/connect/status`    | Onboarding status         |
| `POST`   | `/v1/billing/connect/dashboard` | Stripe dashboard link     |
| `POST`   | `/v1/billing/withdraw`          | Withdraw earnings         |
| `GET`    | `/v1/billing/withdrawals`       | Withdrawal history        |
| `GET`    | `/v1/billing/seller-balance`    | Seller balance            |