# Oscn — 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 Oklahoma State Court Network records across 80+ counties to find cases, review detailed docket information, and track daily court filings. Quickly look up case details by county and district court type to stay informed on legal proceedings and filing activity.

**Category:** Government & Public Data | **Website:** [oscn.net/](https://oscn.net/) | **Docs:** [parse.bot/marketplace/38c20dee-afc2-4dda-9bee-43a11bdfb780/oscn-net-api](https://parse.bot/marketplace/38c20dee-afc2-4dda-9bee-43a11bdfb780/oscn-net-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-oscn-net-api-38c20dee/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_case_details

Retrieves full case details including header information (style, judge, filed date), parties, and docket entries. Use case_number and db from search_cases results. The cmid parameter is recommended for precision when multiple cases share a number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `case_number` | string | Yes | Case number (e.g., 'CF-2026-2214'). |
| `cmid` | string | No | Case Master ID from search_cases results. Recommended for precision when multiple cases share a number. |
| `db` | string | Yes | County identifier (lowercase, e.g., 'tulsa'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oscn-net-api-38c20dee/get_case_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"case_number":"<string>","cmid":"<string>","db":"<string>"}'
```

### get_daily_filings_by_county

Retrieves the daily filing report for a specific county. Data is only available for completed past days (not the current day). Available for a subset of counties (~13 including Tulsa, Oklahoma). Returns all cases filed on the given date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | Yes | Date in MM/DD/YYYY format. Must be a completed past day; today's date returns empty results. |
| `db` | string | No | County name, capitalized (e.g., 'Tulsa', 'Oklahoma'). Must be capitalized — lowercase will not match. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oscn-net-api-38c20dee/get_daily_filings_by_county \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","db":"<string>"}'
```

### list_counties

Returns all Oklahoma county/court database identifiers available for search. Each entry includes a lowercase id (e.g., 'tulsa', 'oklahoma') and the full court name. Use the id value as the db parameter in other endpoints.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oscn-net-api-38c20dee/list_counties \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_district_court_case_types

Returns all district court case type codes and their labels. Use the id value as the case_type parameter in search_cases. Covers criminal, civil, family, probate, traffic, and other case categories.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oscn-net-api-38c20dee/list_district_court_case_types \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_cases

Searches for cases using various filters across Oklahoma district courts. At least one filter (case_type with date range, or lname) should be provided for reliable results. The site caps results at 500; narrow date ranges to paginate through larger sets. Returns case summaries with links to full details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `case_number` | string | No | Specific case number (e.g., 'CF-2026-2214'). |
| `case_type` | string | No | Case type ID from list_district_court_case_types (e.g., '31' for Criminal Felony, '7' for Probate). |
| `db` | string | No | County identifier from list_counties (lowercase, e.g., 'tulsa', 'oklahoma'). |
| `filed_date_h` | string | No | End filing date in MM/DD/YYYY format. |
| `filed_date_l` | string | No | Start filing date in MM/DD/YYYY format. |
| `fname` | string | No | Party first name to search for. |
| `lname` | string | No | Party last name to search for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-oscn-net-api-38c20dee/search_cases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"case_number":"<string>","case_type":"<string>","db":"<string>","filed_date_h":"<string>","filed_date_l":"<string>","fname":"<string>","lname":"<string>"}'
```