# Workday Jobs — 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 retrieve job postings and detailed descriptions from any company's Workday career site. Find open positions across all organizations using Workday's hiring platform and access complete job details in one place.

**Category:** Jobs | **Website:** [healthcare.wd1.myworkdayjobs.com/Search/job/IN-BANGALORE/Senior-Software-Developer_R01123555?source=LinkedIn](https://healthcare.wd1.myworkdayjobs.com/Search/job/IN-BANGALORE/Senior-Software-Developer_R01123555?source=LinkedIn) | **Docs:** [parse.bot/marketplace/b48aeeff-a09e-4097-bc8a-e13ff8b6f986/workday-jobs-api](https://parse.bot/marketplace/b48aeeff-a09e-4097-bc8a-e13ff8b6f986/workday-jobs-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/workday-jobs/`
**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 job

Retrieve full job posting details from a Workday job URL. Returns title, description (plain text by default), location, requirements, hiring organization, and similar jobs. The job must still be live on the career site; removed postings return input_not_found. Accepts any *.myworkdayjobs.com job URL including query parameters (e.g. ?source=LinkedIn).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `include_html` | string | No | Set to 'true' to include raw HTML job description in addition to plain text. Accepted values: 'true', 'false'. |
| `job_url` | string | Yes | Full Workday job posting URL (e.g., https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite/job/US-CA-Santa-Clara/Software-Engineer_JR1234567). Query parameters are stripped automatically. |

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

### Search jobs

Search for jobs on any Workday career site with keyword search and optional facet filters (country, remote type, job category). Returns up to 20 results per request. Use offset and limit for manual pagination over large result sets. Returns matching jobs and available filter facets with their IDs and counts. Facet IDs for filtering are obtained from the facets object in a prior response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `job_category` | string | No | Filter by job category/family group ID (obtain IDs from the facets object in the response, under jobFamilyGroup.values[*].id) |
| `limit` | integer | No | Number of results per page (1-20) |
| `location_country` | string | No | Filter by country ID (obtain IDs from the facets object in the response, under Location_Country.values[*].id) |
| `offset` | integer | No | Offset for pagination (0-based). Advance by incrementing by limit to get the next page of results. |
| `query` | string | No | Search keyword(s) |
| `remote_type` | string | No | Filter by remote work type ID (obtain IDs from the facets object in the response, under remoteType.values[*].id) |
| `site_url` | string | Yes | Workday career site URL (e.g., https://healthcare.wd1.myworkdayjobs.com/Search or https://nvidia.wd5.myworkdayjobs.com/NVIDIAExternalCareerSite) |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/workday-jobs/search-jobs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"job_category":"<string>","limit":"<integer>","location_country":"<string>","offset":"<integer>","query":"<string>","remote_type":"<string>","site_url":"<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.