Developer quickstart

Make your first Parcelum API request in under 10 minutes.

Create a Hub API key, search Texas parcel records, inspect the response shape, and start a CSV export when your workflow needs bulk data.

Get API key API reference

Quick path

1
Create an API key
Sign in to Hub, open Console, and create a key. The key is shown once; store it in your secret manager.
2
Search parcels
Call /v1/parcels with county, tax year, text, valuation, land, improvement, and property classification filters.
3
Export CSV when needed
Paid API tiers can create immutable background export jobs and download completed CSV files from the same API path.

Authentication

Send your API key in the X-API-Key header. The API also accepts Authorization: Bearer for server environments where bearer-token plumbing is already standard.

Check live coverage before choosing counties or tax years for examples and test data.

Base URL

https://api.parcelum.io/api

Search Parcels

These examples call the real public endpoint with a county, tax year, and page size. Add q, valuation filters, land filters, improvement filters, or sort parameters as your workflow needs them.

export PARCELUM_API_KEY="sk_live_..."
export PARCELUM_API_BASE="https://api.parcelum.io/api"

curl -sS "$PARCELUM_API_BASE/v1/parcels?county=dimmit&tax_year=2025&limit=3" \
  -H "X-API-Key: $PARCELUM_API_KEY"

Response Shape

List responses return parcel records plus pagination and search metadata. Full parcel records include nested address, owner, valuation, land, improvement, deed, exemption, permit, and tax-jurisdiction fields when available for the county.

sample response

{
  "parcels": [
    {
      "cad_id": "10001",
      "county": "dimmit",
      "tax_year": 2025,
      "property_address": {
        "full_address": "..."
      },
      "valuation": {
        "market_value": 124500
      }
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "limit": 3,
      "total": 1445,
      "has_next": true
    }
  }
}

CSV Exports

Exports are long-running background jobs on paid API tiers. Create a job with an idempotency key, poll /v1/exports/{job_id}, then download from /v1/exports/{job_id}/download once the status is completed. Public API export scopes are filtered_search and county_year; Hub parcel-list exports are created from saved lists in Hub and then appear in Hub exports.

create filtered-search CSV export

curl -sS "$PARCELUM_API_BASE/v1/exports" \
  -X POST \
  -H "X-API-Key: $PARCELUM_API_KEY" \
  -H "Idempotency-Key: quickstart-$(date +%s)" \
  -H "Content-Type: application/json" \
  -d '{
    "scope": "filtered_search",
    "format": "csv",
    "filters": {
      "county": "dimmit",
      "tax_year": 2025
    }
  }'

SDK Stance

TypeScript and Python SDKs are available as beta GitHub release assets. They are generated from the live OpenAPI document and verified against the API. npm and PyPI publishing are not finalized, so download the beta package asset from the SDK release and install it locally.

npm install ./parcelum-sdk-0.2.0.tgz

Open API reference MCP quickstart SDK release assets