# Texas RRC API

> Texas Railroad Commission permits, wells, leases, operators, production and inspections, cleaned, joined across files, and traceable to the exact state file. Independent of the Railroad Commission of Texas.

Base URL: https://api.texasrrcapi.com (JSON over HTTPS)

## Get a key (no card, no email)

    curl -X POST https://api.texasrrcapi.com/v1/signup

Returns 201 with `api_key` (shown once; save it), `plan` ("free"), `monthly_requests` (1000), `per_second` (2), `max_rows` (100), `docs`.
Free keys are capped at 5 signups per client address per UTC day; over the cap returns 429, use https://texasrrcapi.com/#pricing.

## First data call

    curl "https://api.texasrrcapi.com/v1/production?from=202501&to=202512" -H "X-API-Key: $RRC_KEY"

Monthly statewide oil, gas, condensate and casinghead volumes for 2025.

## Key facts

- Send the key in `X-API-Key`. MCP also accepts `Authorization: Bearer <key>`.
- Free: 1,000 requests/month, 2/s, 100 rows per call, no SQL, no MCP, no bulk.
- Pro ($299/mo): 100,000 requests/month, 10/s, SQL, MCP. Upgrade at https://texasrrcapi.com/#pricing.
- MCP server (Pro and up): https://api.texasrrcapi.com/mcp, Bearer auth. Free keys get 403 on MCP.
- Identical GET requests may be served from the edge cache for up to 5 minutes; cached hits do not count against quota.
- Every response carries `meta.snapshot_id`. Tables that record their source file carry `source_sha256` and `source_uri`; check each table's columns in `/v1/catalog`. Cite the snapshot ID for reproducibility.
- Status (no key): https://api.texasrrcapi.com/v1/status

## Docs

- Full reference: https://texasrrcapi.com/docs
- OpenAPI/interactive: https://api.texasrrcapi.com/docs
- Plans and limits: https://texasrrcapi.com/docs#plans
- Entity endpoints: /v1/operators/{operator_id}, /v1/wells/{api10}, /v1/leases/{lease_id}, /v1/permits/{permit_no}, /v1/tables/{dataset}/{table}, /v1/changes?since=, /v1/account