# api.careers — the careers object an agent calls to get a placement

Staffing & talent placement (NAICS 5613) as a payable machine face. Candidate
and Placement records are typed by O*NET-SOC — the G1 standard itself — and
the placement record carries a 90-day-validatable outcome.

## Quickstart (keyless — the anon sandbox is the floor)

```sh
curl https://api.careers/placements                     # typed OK envelope, labeled example data
curl https://api.careers/placements?status=completed    # branching on the query
curl https://api.careers/occupations                    # O*NET-SOC vocabulary excerpt (real G1 reference data)
curl https://api.careers/pricing                        # the Pricing Document (test mode; binding: false)
curl -X POST https://api.careers/candidates -H 'content-type: application/json' \
  -d '{"name":"Vesper Corven","onetCode":"15-1252.00"}'   # mints into the ephemeral sandbox workspace
```

## What is real and what is example data

Occupation records are a real excerpt of O*NET-SOC 29.0 (U.S. Department of
Labor, CC BY 4.0). Candidate, JobOrder, and Placement seed records are
synthetic example data, labeled `"example": true` on every record — the
sandbox is the real product over simulated data, never a faked demo.

## The B2A ladder

This face onboards agents, not accounts: no OAuth, no credit card. The anon
sandbox is free and keyless. The 402 OFFER boundary (GET /offer) advertises
the whole ladder in one place — pay (metered, test mode today), work (earned
credits via proof-of-work), claim (a human claims your workspace). Settlement
is not active on this deployment; 402 responses are typed boundaries served
as labeled stubs and no billing occurs.

## Verify, don't trust

GET /verify lists the runnable suites for this property, including the
digest-pinned AXP conformance gate (apis-ax-axp@2.6.0).

## Machine surfaces

- Capability card (AXP probe manifest): https://api.careers/.well-known/agents.json
- OpenAPI 3.1 contract: https://api.careers/openapi.json
- Pricing Document: https://api.careers/pricing
- icp.json (agent classes): https://api.careers/icp.json
- Family registry (sibling doors as typed edges): https://api.careers/family.json
- MCP door (streamable HTTP JSON-RPC): POST https://api.careers/mcp
- This projection's G4 coordinates: https://api.careers/projection.json
- This file: https://api.careers/llms.txt
- Conformance (independent verifier): https://api.qa/api.careers

## Machine surfaces

- Capability card (AXP probe manifest): https://api.careers/.well-known/agents.json
- OpenAPI 3.1 contract: https://api.careers/openapi.json
- Pricing Document: https://api.careers/pricing
- icp.json (agent classes): https://api.careers/icp.json
- Family registry (sibling doors as typed edges): https://api.careers/family.json
- This file: https://api.careers/llms.txt
- Conformance (independent verifier): https://api.qa/api.careers

## The family

- apis.do — sibling estate face — the API gateway: https://apis.do/