# Data requests

> Documentation index: [llms.txt](https://westkite.com/docs/llms.txt). Every page is also at its URL plus `.md`.

Records a request for data West Kite does not hold yet: a county, a field or a kind of record. Free.

```endpoint
POST /v1/requests
```

## Body

| Name | Type | Description |
|---|---|---|
| `kind` | string | Required. `place`, `field`, `source` or `other`. |
| `place` | string | Where, such as `Cobb County, GA`. Up to 200 characters. |
| `field` | string | The field, such as `last_sale_price`. Up to 120 characters. |
| `note` | string | Required. What you need and why, up to 2,000 characters. |

## Request

```curl
curl https://api.westkite.com/v1/requests \
  -H "Authorization: Bearer $WESTKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "kind": "place", "place": "Cobb County, GA", "note": "Industrial owners for a broker client." }'
```

```typescript
await fetch("https://api.westkite.com/v1/requests", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.WESTKITE_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({ kind: "place", place: "Cobb County, GA", note: "Industrial owners for a broker client." }),
});
```

```python
import os, requests

requests.post(
    "https://api.westkite.com/v1/requests",
    headers={"Authorization": f"Bearer {os.environ['WESTKITE_API_KEY']}"},
    json={"kind": "place", "place": "Cobb County, GA", "note": "Industrial owners for a broker client."},
)
```

## Response

```json 201
{
  "data": { "id": "7b21c0d4-…", "status": "open" },
  "missing": [],
  "billing": { "operation_id": "op_aa09…", "operation": "requests", "charged_usd": 0, "balance_usd": 9.35 },
  "request_id": "req_31c8…"
}
```

It answers `201 Created`. Your team can follow its requests in the dashboard. An agent that hits `not_covered` in [missing](https://westkite.com/docs/api/making-requests.md#missing-data) can file a request on the spot.
