docs / 05
API reference
Every endpoint the Worker serves, grouped by the credential it needs.
Public
No credentials required.
| Method | Path | Description |
|---|---|---|
| GET | /health | Liveness check. Returns { "ok": true }. |
| GET | /api/coverage | National coverage totals by status and a per-state breakdown. |
| GET | /api/counties | County coverage rows. Filters: status, state, limit, offset. |
| GET | /api/counties/:fips | One county by five-digit FIPS, or 404. |
Session
Requires the Better Auth session cookie.
| Method | Path | Description |
|---|---|---|
| GET | /api/me | Current session as JSON, or 401 when signed out. |
| POST | /api/tokens/trial | Issue the 30-day trial token (50 credits). 409 if one is active. |
| GET | /api/tokens | List the account's tokens. Raw values and hashes never appear. |
| POST | /api/tokens/:id/revoke | Revoke a token, or 404 if it is not the account's. |
| POST | /api/auth/* | Better Auth: sign-up, sign-in, sign-out, verification, passkeys. |
Bearer token
Requires Authorization: Bearer <token> and consumes credits.
| Method | Path | Description |
|---|---|---|
| GET | /api/parcels | Metered parcel reads. Filters: county_fips, limit. |
| GET | /api/usage | The calling token's balance and recent ledger. |
Parcel reads
curl "https://parcel.reeeally.ai/api/parcels?county_fips=06037&limit=100" \
-H "Authorization: Bearer $PARCEL_TOKEN"| Query | Meaning |
|---|---|
| county_fips | Optional five-digit county FIPS. Omit for all loaded parcels. |
| limit | Records to return, 1–1000. Default 100. |
Usage
curl https://parcel.reeeally.ai/api/usage \
-H "Authorization: Bearer $PARCEL_TOKEN"Admin
The ops console under /admin is restricted to admin users and is not part of the public API.