### POST /api/v4/exports

**Create an export** (`create_export`). Quote a CSV or JSONL file of a search (or of a semantic search by search_id). The job waits for approval; a 0¢ quote starts at once.

Free. API key required. Success: `202`. Accepts `Idempotency-Key`.

#### Body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `collection` | "startups" \| "investors" \| "funding_rounds" \| "exits" |  |  |
| `search_id` | string |  | meta.search_id of a semantic search: exports exactly that ranking, with its filter, fields and expands. |
| `filter` | object |  |  |
| `sort` | array<string> |  |  |
| `fields` | array<string> |  |  |
| `expand` | array<string> |  |  |
| `focus` | object |  |  |
| `format` | "csv" \| "jsonl" | yes |  |
| `client_reference` | string |  | Your own reference (≤200 chars). Filter job lists by it to find work again. |

#### Response

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | object | yes | The result. |
| `data.id` | string | yes | UUID. |
| `data.type` | "export" | yes |  |
| `data.status` | "quoting" \| "awaiting_approval" \| "queued" \| "running" \| "canceling" \| "succeeded" \| "partially_succeeded" \| "failed" \| "canceled" | yes |  |
| `data.client_reference` | string \| null | yes |  |
| `data.created_at` | string \| null | yes |  |
| `data.finished_at` | string \| null | yes |  |
| `data.collection` | any | yes |  |
| `data.format` | any | yes |  |
| `data.quote` | object | yes |  |
| `data.quote.quote_id` | string | yes | UUID. |
| `data.quote.rows` | integer | yes |  |
| `data.quote.max_cost_usd_cents` | integer | yes | The most approval can charge. |
| `data.quote.expires_at` | string | yes | ISO 8601 timestamp (UTC). |
| `data.quote.lines` | array<object> | yes |  |
| `data.progress` | object | yes |  |
| `data.progress.rows` | integer | yes |  |
| `data.cost` | object | yes |  |
| `data.cost.reserved_usd_cents` | integer | yes | USD cents. |
| `data.cost.charged_usd_cents` | integer | yes | USD cents. |
| `data.cost.refunded_usd_cents` | integer | yes | USD cents. |
| `data.result` | object \| null | yes |  |
| `data.result.download_url` | string \| null | yes |  |
| `data.result.url_expires_at` | string \| null |  |  |
| `data.result.artifact_expires_at` | string \| null | yes |  |
| `data.result.filename` | string |  |  |
| `data.result.rows` | integer | yes |  |
| `data.result.truncated_to_quote` | boolean |  |  |
| `data.result.note` | string |  |  |
| `data.failure` | object \| null | yes |  |
| `data.failure.code` | string | yes |  |
| `data.failure.message` | string \| null | yes |  |
| `meta.request_id` | string | yes | Request id (also in X-Request-Id). |
| `meta.cost_usd_cents` | number | yes | Charged for this request, in USD cents. |

#### Errors

| Status | Code | Meaning |
| --- | --- | --- |
| 400 | `VALIDATION_FAILED` | The request does not match the endpoint contract. |
| 400 | `UNKNOWN_FIELD` | A field name is not part of this collection. |
| 400 | `VALUE_UNKNOWN` | A filter value does not match any known value. |
| 401 | `UNAUTHORIZED` | The API key is missing, invalid or revoked. |
| 409 | `IDEMPOTENCY_MISMATCH` | This Idempotency-Key was already used with a different request. |
| 409 | `IDEMPOTENCY_IN_PROGRESS` | A request with this Idempotency-Key is still running. |
| 410 | `SEARCH_EXPIRED` | The ranked search (search_id) expired after 30 minutes. |
| 429 | `RATE_LIMITED` | Too many requests in the current window. |
| 429 | `QUOTA_EXCEEDED` | A daily or concurrency quota is used up. |
| 500 | `INTERNAL_ERROR` | An unexpected server error. |
| 503 | `SERVICE_UNAVAILABLE` | A dependency is temporarily unavailable. |

#### Example

```bash

curl -X POST 'https://startup-seeker.com/api/v4/exports' \
  -H "Authorization: Bearer $STARTUPSEEKER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "collection": "startups",
    "filter": {
      "hq_country": "BE"
    },
    "fields": [
      "name",
      "domain",
      "total_funding_usd"
    ],
    "format": "csv",
    "client_reference": "be-startups"
  }' \
  -H "Idempotency-Key: $(uuidgen)"

```