# Rics — 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 the RICS-regulated surveying firm directory by location, firm name, keyword, and service category, and retrieve suggested places/locations to power autocomplete.

**Category:** Business Directories | **Website:** [rics.org/](https://rics.org/) | **Docs:** [parse.bot/marketplace/df6c8f1a-0ff3-497f-b3e8-c62d2d05ba5f/rics-org-api](https://parse.bot/marketplace/df6c8f1a-0ff3-497f-b3e8-c62d2d05ba5f/rics-org-api)

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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/rics/`
**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 places

Get available locations/places for use in search_firms location parameter. Returns matching places with their IDs and parent regions. Use the place name in the location parameter of search_firms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `country` | string | No | Country code filter. |
| `query` | string | No | Filter query to match place names (e.g. 'London', 'Manchester'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/rics/get-places \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"country":"<string>","query":"<string>"}'
```

### Search firms

Search for RICS regulated surveying firms by location, firm name, or keyword. Returns paginated results with firm contact details, service areas, and available service filter facets. At least one of location, firm_name, or keyword should be provided for meaningful results. Pagination advances via the page parameter; service_facets in the response enumerate available service filters with their counts for the current query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `firm_name` | string | No | Firm name to search for. |
| `keyword` | string | No | Keyword search (e.g. 'party wall', 'valuation', 'building survey'). |
| `location` | string | No | Location name to search within (e.g. 'London', 'Manchester', 'Birmingham'). |
| `page` | integer | No | Page number for pagination. |
| `page_size` | integer | No | Results per page. |
| `service_id` | string | No | Service type ID for filtering results. IDs available from the service_facets field in search results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/rics/search-firms \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"firm_name":"<string>","keyword":"<string>","location":"<string>","page":"<integer>","page_size":"<integer>","service_id":"<string>"}'
```

## Next steps

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