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_HERE

2. 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