# Texas Public Utility Commission — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search Texas Public Utility Commission dockets and filings to find case information, retrieve documents, and track utility regulatory submissions by control number or filing date. Access details about utility types, item classifications, and specific document links for PUCT Interchange proceedings.

**Category:** Government & Public Data | **Website:** [puc.texas.gov/](https://puc.texas.gov/) | **Docs:** [parse.bot/marketplace/2c402a1b-333f-4bd4-b710-1ae9178f0a4c/puc-texas-gov-api](https://parse.bot/marketplace/2c402a1b-333f-4bd4-b710-1ae9178f0a4c/puc-texas-gov-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Daily filing search

Search for filings submitted on a specific date or within a date range. Returns paginated results including control number, item number, item type, filing party, and description for each filing.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_filed_from` | string | Yes | Start date in MM/DD/YYYY format. |
| `date_filed_to` | string | No | End date in MM/DD/YYYY format. |
| `page` | integer | No | Page number for paginated results. |
| `utility_type` | string | No | Utility type filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/daily-filing-search \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date_filed_from":"<string>","date_filed_to":"<string>","page":"<integer>","utility_type":"<string>"}'
```

### Get case filings

Retrieve all filings for a specific case/docket. Returns the complete list of filings for the given control number. Optionally filter by document type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `control_number` | string | Yes | Control number of the case (e.g. 59697). |
| `document_type` | string | No | Filter by document type code. Use get_item_types endpoint for the full list of accepted values. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/get-case-filings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"control_number":"<string>","document_type":"<string>"}'
```

### Get document details

Retrieve documents and metadata for a specific filing item within a case. Returns document links (PDF/ZIP) and filing metadata including party, case style, and description.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `control_number` | string | Yes | Control number of the case (e.g. 59697). |
| `item_number` | string | Yes | Item number of the filing (e.g. 1). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/get-document-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"control_number":"<string>","item_number":"<string>"}'
```

### Get item types

Retrieve available item/document type filter options for use with search endpoints. Returns a static list of document type codes and their display names.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/get-item-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get recently issued control numbers

Retrieve recently issued control numbers (last 15 days) from the PUCT new filings page. Each entry includes the control number, date filed, and case description.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/get-recently-issued-control-numbers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get utility types

Retrieve available utility type filter options for use with search endpoints. Returns a static list of utility type codes and their display names.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/get-utility-types \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search dockets

Search for dockets/cases in the PUCT Interchange system. Returns paginated results (25 per page) sorted descending by default. At least one filter (control_number, date range, case_style, or filing_description) should be provided for meaningful results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `case_style` | string | No | Case style or description keywords to filter by. |
| `control_number` | string | No | Docket control number to search for. |
| `date_filed_from` | string | No | Start date in MM/DD/YYYY format. |
| `date_filed_to` | string | No | End date in MM/DD/YYYY format. |
| `document_type` | string | No | Filter by document type code. Use get_item_types endpoint for the full list of accepted values. |
| `filing_description` | string | No | Filing description keywords to filter by. |
| `page` | integer | No | Page number for paginated results. |
| `utility_type` | string | No | Utility type filter. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/texas-public-utility-commission/search-dockets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"case_style":"<string>","control_number":"<string>","date_filed_from":"<string>","date_filed_to":"<string>","document_type":"<string>","filing_description":"<string>","page":"<integer>","utility_type":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.