# Gassaferegister — 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 for Gas Safe registered businesses and engineers across the UK by city or postcode, then retrieve detailed information about their qualifications and services. Find certified gas engineers in your area and verify their registration status to ensure safe, compliant work on your gas appliances.

**Category:** Government & Public Data | **Website:** [gassaferegister.co.uk/](https://gassaferegister.co.uk/) | **Docs:** [parse.bot/marketplace/78e68814-3355-4cdb-ab2e-3285650b1142/gassaferegister-co-uk-api](https://parse.bot/marketplace/78e68814-3355-4cdb-ab2e-3285650b1142/gassaferegister-co-uk-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/gassaferegister/`
**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 business engineers

Look up a specific Gas Safe registered business by its registration number and return its details along with all registered engineers. Uses the 'Check' mode on the Gas Safe Register to directly retrieve the business.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `registration_number` | string | Yes | Gas Safe registration number (e.g. '167722') |

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

### Search businesses

Search for Gas Safe registered businesses by location. Returns business details with contact info and optionally fetches engineer details for each business. Supports pagination (10 results per page). Results are randomly ordered by the upstream site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include_engineers` | string | No | Whether to fetch engineer details for each business: 'true' or 'false'. Setting to 'true' makes additional requests per business and is slower. |
| `location` | string | Yes | City name (e.g. 'Cambridge') or UK postcode (e.g. 'CB1 1JY') |
| `page` | integer | No | Page number (1-indexed, 10 results per page) |
| `service_type` | string | No | Type of gas service: 'Domestic' or 'Commercial' |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gassaferegister/search-businesses \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"include_engineers":"<string>","location":"<string>","page":"<integer>","service_type":"<string>"}'
```

### Search businesses basic

Search for Gas Safe registered businesses by location without fetching engineer details. Faster than search_businesses as it only loads the results listing page. Results are randomly ordered by the upstream site.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `location` | string | Yes | City name (e.g. 'Cambridge') or UK postcode (e.g. 'CB1 1JY') |
| `page` | integer | No | Page number (1-indexed, 10 results per page) |
| `service_type` | string | No | Type of gas service: 'Domestic' or 'Commercial' |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/gassaferegister/search-businesses-basic \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","service_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.