The Cover StoryStable · v1

Build hiring,
in one API

Post jobs, receive matched seekers, and integrate Qudra into your ATS, job board, or HR platform — all via a clean, well-typed REST API with first-class SDKs for JavaScript, Python, and PHP.

Get your API key →Read the Jobs API

★ Bilingual errors★ HMAC-signed webhooks★ Saudi-first matching

Stable — v1

The current production API version is v1. We follow URI versioning (/v1/…); breaking changes will land on /v2/… with a 12-month sunset for /v1/….

Why integrate

SECTION 01 — VALUE

A short, opinionated API. Bilingual by design. Saudi-first by default. Built for partners who'd rather ship than re-model the local context.

Saudi-first matching

Embeddings, salary ranges, and Nitaqat-aware filtering are baked into the platform — you don't need to model the local context yourself.

Webhooks that don't lie

Every event is HMAC-signed (X-Qudra-Signature), timestamped, and replay-safe via timingSafeEqual on the server.

Bilingual, by design

Every error returns both message (English) and messageAr (Arabic) so your UI shows the right copy without a translation pass.

Get started in 60 seconds

# 1. Get your API key from https://qudrah.io/partner/api-keys
export QUDRA_API_KEY="qk_live_…"
 
# 2. Post your first job
curl -X POST https://api.qudrah.io/v1/partner/jobs \
  -H "Authorization: Bearer $QUDRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Senior Backend Engineer",
    "description": "Build the Qudra matching pipeline…",
    "city": "Riyadh",
    "employment_type": "full_time",
    "salary_min": 18000,
    "salary_max": 30000,
    "currency": "SAR"
  }'

You'll get back a job_… id, a public qudra_url, and embedding_status: "processing" — the embedding pipeline runs asynchronously and the job becomes match_ready within ~30 seconds.

Build hiring, in one API