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

# API Reference

> Base URL, authentication, and error codes.

## Base URL

```
https://api.buyparceldata.com
```

***

## Authentication

Pass your API key as a Bearer token in the `Authorization` header on every request:

```bash theme={null}
curl -X POST https://api.buyparceldata.com/parcels/area \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '...'
```

See [Authentication](/guides/authentication) for how to create and manage keys.

***

## Endpoints

| Method | Path               | Description                                                    |
| ------ | ------------------ | -------------------------------------------------------------- |
| `POST` | `/parcels/area`    | Find parcels intersecting one or more polygons (returns UUIDs) |
| `POST` | `/parcels/query`   | Filter parcels by field values (returns full records)          |
| `GET`  | `/parcels/point`   | Find parcels containing a lat/lng point                        |
| `GET`  | `/parcels/address` | Find parcels by street address                                 |

**Typical workflow:** use `/area` to identify parcels in a geography, then pass the returned UUIDs to `/query` with the `bpd_uuid in` filter to fetch full records in one call.

***

## Error codes

| Status                      | Meaning                                                                                  |
| --------------------------- | ---------------------------------------------------------------------------------------- |
| `200 OK`                    | Request succeeded.                                                                       |
| `400 Bad Request`           | Invalid field, operator, or missing required scope.                                      |
| `401 Unauthorized`          | Missing or invalid API key.                                                              |
| `403 Forbidden`             | No active subscription.                                                                  |
| `422 Unprocessable Entity`  | Request body failed schema validation.                                                   |
| `429 Too Many Requests`     | Monthly request limit exceeded. See [Rate limits](/guides/rate-limits).                  |
| `500 Internal Server Error` | Unexpected error. Contact [support@buyparceldata.com](mailto:support@buyparceldata.com). |

All error responses:

```json theme={null}
{ "detail": "Human-readable error message" }
```