API
/api
The API ships
with V2.
Programmatic access to the Picked engine. Read and write endpoints, webhooks, OpenAPI spec, TypeScript and Python SDKs at launch. We will not ship an API that breaks; not before V1 has settled. Register below for early access.
Request early access →See the product surface →
Ships with V2 API·OpenAPI spec at launch·TypeScript and Python SDKs
What is in scope
What ships with this.
Read endpoints.
Roles, candidates, finalists, decisions, audit-trail manifests. Same data model as the UI surfaces, exposed cleanly.
Write endpoints.
Post a role, advance a candidate, override a finalist rank, close a role. Mutations log to the same audit trail as the UI actions.
Webhooks.
Event-driven push for role-posted, first-applicant, finalist-arrived, decision-made, override-logged, role-closed. HMAC-signed; retry with exponential backoff.
OAuth 2 plus API keys.
OAuth 2 for user-context apps, API keys for server-to-server. Scopes per-endpoint; least-privilege defaults.
Rate-limited free tier plus paid tiers.
Free tier for development; paid tiers for production volume. Per-key limits, transparent quota headers, no surprise throttling.
OpenAPI 3.1 spec.
Published at launch. Generates clients for any language; we ship official clients in TypeScript and Python; community clients welcome.
Sandbox environment.
A read-write sandbox with synthetic data for testing integrations without consuming real candidate budget.
Backwards-compatible versioning.
Date-prefix-versioned endpoints (v2026-01-01 style). No breaking changes within a major version; major versions get 12-month deprecation notice.
Why we are not shipping this yet
Candid about the constraint.
The constraint

An API is a contract. Once it is published, every change is a customer-facing decision; every breaking change is a migration. We are still learning how customers use the product; pinning the API shape before the V1 surface has run for a full hiring cycle would mean either shipping an API we will regret or shipping one we constantly version away from.

What would have to be true

The V2 API ships when the V1 product has run long enough for the data model to settle, when we have the engineering team to maintain it alongside the UI surfaces, and when we have a meaningful sample of customers asking for specific endpoints (rather than asking for "an API" in the abstract). The combination is V2 in mid-2027.

The V1 alternative
What you can do today.

V1 has no public API. Customers who need programmatic access today have two options: the ATS export at finalist-decision time (covered by the integrations directory), which pushes finalist records to Greenhouse, Ashby, Workable, or Lever; or the Picked-managed CSV export, which is available on demand from the admin console.

For customers building custom internal tooling against Picked, the V1 path is to register early-access interest below and start a conversation. We can sometimes accommodate specific use cases with a limited custom integration even before V2; this is by exception, not a sustainable pattern.

See the integrations directory.
What plays alongside Picked today. ATS export at finalist-decision time, calendar and comms integrations live or in progress.
Read the V1 alternative →
Building against Picked?
Get on the V2 API early-access list.
Picked emails this address about the V2 API specifically. One-click unsubscribe. EU residency; Resend EU. We will not add you to any other list without your separate opt-in.
V1 runs through the UI.
Use the export today.
Build on the API when it lands.
Post a role for free →See the V1 alternative
Picked API · Picked.ai