# Boss — 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 and browse job listings from boss.az with detailed vacancy information, and instantly access company contact details including emails and phone numbers directly from job postings. Filter opportunities by job categories and regions to find positions that match your needs.

**Category:** Jobs | **Website:** [boss.az/](https://boss.az/) | **Docs:** [parse.bot/marketplace/2e1677b0-d276-4780-a915-3ca65ee59559/boss-az-api](https://parse.bot/marketplace/2e1677b0-d276-4780-a915-3ca65ee59559/boss-az-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/boss/`
**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 all categories

Retrieve all job categories and their subcategories. Returns a flat array of top-level categories, each containing a children array of subcategories with id, name, and parentId. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/boss/get-all-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get all regions

Retrieve all available regions and locations. Returns a flat array of region objects with numeric IDs and names. Used to obtain valid region_ids for search_vacancies filtering.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/boss/get-all-regions \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get company profile

Get a company profile by its numeric ID. Returns company name, contact details, region, specialization, and count of published vacancies. Company IDs are available from search_vacancies results under profile.id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the company. Available from search_vacancies results under profile.id. |

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

### Get vacancy details

Get full details of a specific job vacancy by its numeric ID. Returns position name, company info, salary range, contact details (email, phones), HTML description, requirements, and responsibilities. The profile sub-object links to the employer company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `id` | string | Yes | The numeric ID of the vacancy. Available from search_vacancies results. |

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

### Search vacancies

Search for job vacancies with optional filters including keyword, category, region, salary range, education, and experience. Returns paginated results with contact info (email, phones). Paginates via cursor (endCursor). Each vacancy carries a profile sub-object linking to the employer company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `after` | string | No | Cursor for pagination, use endCursor from a previous response. |
| `category_ids` | string | No | JSON array of job category IDs to filter by (e.g. "[37,38]"). IDs available from get_all_categories. |
| `education_ids` | string | No | JSON array of education level IDs to filter by. |
| `experience_ids` | string | No | JSON array of experience level IDs to filter by. |
| `limit` | integer | No | Number of results to return per page. |
| `region_ids` | string | No | JSON array of region/city IDs to filter by (e.g. "[1,4]"). IDs available from get_all_regions. |
| `salary_max` | integer | No | Maximum salary filter. |
| `salary_min` | integer | No | Minimum salary filter. |
| `search_term` | string | No | Keyword to search for in vacancy listings. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/boss/search-vacancies \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"after":"<string>","category_ids":"<string>","education_ids":"<string>","experience_ids":"<string>","limit":"<integer>","region_ids":"<string>","salary_max":"<integer>","salary_min":"<integer>","search_term":"<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.