# Northwind API Reference — v2

Base URL: `https://api.northwind.dev/v2` · Auth: `Bearer` token

## POST /jobs

Create an ingestion job.

### Request

```json
{
  "type": "sync",
  "source": "warehouse",
  "priority": "normal"
}
```

### Parameters

| Field      | Type   | Required | Notes                     |
| ---------- | ------ | -------- | ------------------------- |
| `type`     | string | yes      | `sync` or `backfill`      |
| `source`   | string | yes      | Registered source id      |
| `priority` | string | no       | `low` · `normal` · `high` |

### Responses

| Status | Meaning                              |
| ------ | ------------------------------------ |
| 201    | Job created; body contains `job_id`  |
| 409    | A job for this source is in flight   |
| 422    | Validation failed; see `errors[]`    |

## GET /jobs/{id}

Fetch job status. Poll at ≥5s intervals; webhooks are
preferred for completion events.

```bash
curl -H "Authorization: Bearer $TOKEN" \
  https://api.northwind.dev/v2/jobs/job_8fk2
```