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

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/get_all_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/get_all_regions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/get_company_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/get_vacancy_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-boss-az-api-2e1677b0/search_vacancies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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>"}'
```