# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/findapprenticeship-service/`
**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 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/credits/findapprenticeship-service/get-apprenticeship-detail \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/findapprenticeship-service/get-search-filters \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/findapprenticeship-service/get-total-listing-count \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/findapprenticeship-service/search-apprenticeships \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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>"}'
```

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