Krinai API Integration Guide
Welcome to the Krinai Developer Documentation. This guide will walk you through authenticating, fetching jobs, managing applications, and receiving real-time webhook events.
1. Authentication
Krinai uses API keys to authenticate requests. You can view and manage your API keys in the Krinai Dashboard under Settings > Integrations.
Provide your API key in the x-api-key header of all API requests:
x-api-key: krnai_live_YOUR_API_KEY_HERE2. Fetching Jobs and Applications
You can retrieve your synced jobs and candidate applications by calling our REST endpoints.
Get Active Jobs
curl -X GET https://krinaiapi.ziontech.tech/api/v1/jobs \
-H "x-api-key: krnai_live_YOUR_API_KEY_HERE"Returns a list of all active job postings for your tenant.
Get Applications
curl -X GET https://krinaiapi.ziontech.tech/api/v1/jobs/YOUR_JOB_ID/applications \
-H "x-api-key: krnai_live_YOUR_API_KEY_HERE"Returns applications for a specific job ID. The response includes the \`ai_score\` which indicates the candidate's match percentage.
3. Editing Jobs and Applications
You can programmatically update your job listings and applicant statuses using the Krinai API.
Update a Job
Send a PATCH request to edit fields like title, location, or status (e.g. to close a job).
curl -X PATCH https://krinaiapi.ziontech.tech/api/v1/jobs/YOUR_JOB_ID \
-H "x-api-key: krnai_live_YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"title": "Senior Frontend Engineer",
"status": "closed"
}'Update Application Status
Send a PATCH request to change the candidate's pipeline status. Valid statuses: \`received\`, \`under_review\`, \`accepted\`, \`rejected\`.
curl -X PATCH https://krinaiapi.ziontech.tech/api/v1/jobs/YOUR_JOB_ID/applications/YOUR_APP_ID/status \
-H "x-api-key: krnai_live_YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"status": "accepted"
}'4. Setting Up Webhooks (Real-time Sync)
Instead of polling the API to see if a candidate has been scored, you can register a webhook destination. Krinai will send an HTTP POST request to your URL whenever a relevant event occurs.
Registering a Webhook
Send a POST request to register your listener URL.
curl -X POST https://krinaiapi.ziontech.tech/api/v1/webhooks \
-H "x-api-key: krnai_live_YOUR_API_KEY_HERE" \
-H "Content-Type: application/json" \
-d '{
"url": "https://your-system.com/api/webhooks/krinai",
"events": ["application.scored", "application.submitted"]
}'Webhook Payload Example
When an event occurs, your endpoint will receive a payload like this:
{
"event_type": "application.scored",
"data": {
"application_id": "123e4567-e89b-12d3-a456-426614174000",
"job_id": "987fcdeb-51a2-43d7-9012-345678901234",
"ai_score": 92,
"candidate_name": "Jane Doe",
"status": "scored"
},
"created_at": "2026-05-24T10:00:00Z"
}Need more detailed endpoint schemas?
View API Reference