# Sarasotaclerk — 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 and retrieve official land and court records from Sarasota County including foreclosures and Lis Pendens documents by name, date, or document type. Access detailed record information with full pagination support to find the specific legal documents you need.

**Category:** Government & Public Data | **Website:** [sarasotaclerk.com/](https://sarasotaclerk.com/) | **Docs:** [parse.bot/marketplace/72724970-6052-4582-893b-abe7fbad305d/sarasotaclerk-com-api](https://parse.bot/marketplace/72724970-6052-4582-893b-abe7fbad305d/sarasotaclerk-com-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/sarasotaclerk/`
**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

### Get document types

Retrieve the list of all available document types and their corresponding numeric indices for use with the doc_types parameter in search_official_records.

**Estimated cost:** Metered

_No parameters required._

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

### Get official record detail

Retrieve full details for a specific official record by its unique instrument number. Returns the matching record with all available fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `instrument_number` | string | Yes | The unique instrument number identifying the record (e.g. '2026021479'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sarasotaclerk/get-official-record-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"instrument_number":"<string>"}'
```

### Search official records

Search Official Records (Land Records) by name, date range, and document types. Returns paginated results with 12 records per page. Narrow your search with specific names and short date ranges to avoid upstream timeouts on broad queries.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date_from` | string | No | Recording date range start in MM/DD/YYYY format. |
| `date_to` | string | No | Recording date range end in MM/DD/YYYY format. |
| `doc_types` | string | No | Comma-separated list of document type indices. Use get_document_types to retrieve the full list of available indices and labels. |
| `first_name` | string | No | First name of party. |
| `last_name` | string | No | Last name or business name of party. |
| `max_pages` | integer | No | Maximum number of result pages to retrieve (12 results per page). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/sarasotaclerk/search-official-records \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"date_from":"<string>","date_to":"<string>","doc_types":"<string>","first_name":"<string>","last_name":"<string>","max_pages":"<integer>"}'
```

## 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.