# Gassaferegister — 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 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-gassaferegister-co-uk-api-78e68814/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-gassaferegister-co-uk-api-78e68814/get_business_engineers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-gassaferegister-co-uk-api-78e68814/search_businesses \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-gassaferegister-co-uk-api-78e68814/search_businesses_basic \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"location":"<string>","page":"<integer>","service_type":"<string>"}'
```