# CVS Health — 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 apply for CVS Health job openings across multiple categories, locations, and roles. Filter positions by keyword, category, or location to find relevant opportunities and get direct links to submit your application.

**Category:** Jobs | **Website:** [cvshealth.com/](https://cvshealth.com/) | **Docs:** [parse.bot/marketplace/bff810f2-ad5c-4d97-abda-2f7c442397d1/cvshealth-com-api](https://parse.bot/marketplace/bff810f2-ad5c-4d97-abda-2f7c442397d1/cvshealth-com-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-cvshealth-com-api-bff810f2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_apply_url

Get the job detail page URL for a given job requisition ID. Constructs the canonical CVS Health careers page URL where users can view and apply for the position.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Job requisition ID (e.g. 'R0863103') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/get_apply_url \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### get_job_detail

Retrieve full details for a specific CVS Health job posting by its requisition ID. Returns the complete job description (HTML), location, category, employment type, posted date, and direct Workday application URL. Expired or removed job IDs return a stale_input error with kind 'input_not_found'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Job requisition ID from search results (format: 'R' followed by digits, e.g. 'R0863103') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/get_job_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### get_jobs_by_category

Search CVS Health job listings filtered by category keyword. The category string is used as a search keyword, so results are relevance-ordered by category match. Common categories include Pharmacy, Corporate, Innovation and Technology, Warehouse Fulfillment Transportation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Category name to search for (e.g. 'Corporate', 'Pharmacy', 'Innovation and Technology') |
| `from` | integer | No | Pagination offset |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/get_jobs_by_category \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","from":"<integer>"}'
```

### get_jobs_by_location

Search CVS Health job listings filtered by location keyword. The location string is used as a search keyword, so results are relevance-ordered by location match. Accepts city names, state names, or 'Remote'.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | integer | No | Pagination offset |
| `location` | string | No | Location name to search for (e.g. 'Remote', 'New York', 'California', 'Wichita') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/get_jobs_by_location \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","location":"<string>"}'
```

### get_similar_jobs

Find jobs related to a given job ID by using the job requisition ID as a search keyword. Returns a list of job listings that match the ID pattern, which often surfaces sibling roles in the same requisition family.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_id` | string | Yes | Target job requisition ID (e.g. 'R0863103') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/get_similar_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"job_id":"<string>"}'
```

### search_jobs

Full-text search over CVS Health job listings. Keywords match against job title, description, category, and location. Results are ordered by relevance. Pagination via offset; each page returns up to `limit` jobs. Omitting keywords returns all available listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | integer | No | Pagination offset (number of results to skip) |
| `keywords` | string | No | Search keywords to match against job title, description, category, and location (e.g. 'pharmacy technician', 'developer', 'Remote') |
| `limit` | integer | No | Maximum number of results to return per page |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/search_jobs \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","keywords":"<string>","limit":"<integer>"}'
```

### search_jobs_by_keyword

Search CVS Health job listings by keyword query. Functionally equivalent to search_jobs but with a simpler interface focused on keyword search. Returns paginated results ordered by relevance.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `from` | integer | No | Pagination offset |
| `query` | string | No | Keywords to search for in job listings |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cvshealth-com-api-bff810f2/search_jobs_by_keyword \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from":"<integer>","query":"<string>"}'
```