# Findapprenticeship Service — 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 and browse live apprenticeship vacancies across the UK, filter opportunities by location and job type, and view detailed information about specific positions to find the right apprenticeship match. Access comprehensive listing counts and filter options to narrow down your search.

**Category:** Jobs | **Website:** [findapprenticeship.service.gov.uk/](https://findapprenticeship.service.gov.uk/) | **Docs:** [parse.bot/marketplace/331b4d10-50bb-477e-966e-731971186d82/findapprenticeship-service-gov-uk-api](https://parse.bot/marketplace/331b4d10-50bb-477e-966e-731971186d82/findapprenticeship-service-gov-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-findapprenticeship-service-gov-uk-api-331b4d10/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_apprenticeship_detail

Get full details for a specific apprenticeship vacancy including description, wage, hours, skills, training provider, course contents, and employer information. Requires the vacancy reference code from search results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `vacancy_ref` | string | Yes | Vacancy reference code (e.g. VAC2000036585). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-findapprenticeship-service-gov-uk-api-331b4d10/get_apprenticeship_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"vacancy_ref":"<string>"}'
```

### get_search_filters

Get all available filter options for apprenticeship search including distance options, sort options, apprenticeship levels, job categories, and apprenticeship types. No parameters required. Useful for discovering valid filter values before calling search_apprenticeships.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-findapprenticeship-service-gov-uk-api-331b4d10/get_search_filters \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_total_listing_count

Get the total number of apprenticeship vacancies currently listed on the service. No parameters required. Returns a single count value.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-findapprenticeship-service-gov-uk-api-331b4d10/get_total_listing_count \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_apprenticeships

Full-text search over apprenticeship vacancies with filters for keyword, location, distance, levels, categories, and more. Returns paginated results sorted by the specified criteria. Paginates via page_number. Each result is a summary; use get_apprenticeship_detail with the vacancyReference for full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `apprenticeship_types` | string | No | Comma-separated types: Foundation, Standard. |
| `disability_confident` | boolean | No | Only show disability confident companies. |
| `distance` | string | No | Radius in miles from location. |
| `exclude_national` | boolean | No | Hide companies recruiting nationally. |
| `level_ids` | string | No | Comma-separated apprenticeship level IDs: 2, 3, 4, 5, 6, 7. |
| `location` | string | No | City or postcode to search near. |
| `page_number` | integer | No | Page number of results. |
| `route_ids` | string | No | Comma-separated job category IDs: 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15. |
| `search_term` | string | No | Job title or company name to search for. |
| `sort` | string | No | Sort order for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-findapprenticeship-service-gov-uk-api-331b4d10/search_apprenticeships \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"apprenticeship_types":"<string>","disability_confident":"<boolean>","distance":"<string>","exclude_national":"<boolean>","level_ids":"<string>","location":"<string>","page_number":"<integer>","route_ids":"<string>","search_term":"<string>","sort":"<string>"}'
```