# Texas Public Utility Commission — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/daily_filing_search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/get_case_filings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/get_document_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/get_item_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/get_recently_issued_control_numbers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/get_utility_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-puc-texas-gov-api-2c402a1b/search_dockets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```