REST API · MCP server · webhooks

Build on Iraq's job board

Post and manage jobs from your own systems, pull applications into your HR tools, and connect AI agents to IR4Q.

Developer plan
$49
30 days, does not renew
Rate limit
60
requests per minute per key
Webhooks
Signed
new application events

Start in 3 steps

  1. 1
    Buy the Developer plan

    $49 for 30 days from Billing. Pay once by card.

  2. 2
    Create a key

    In Developer. Keys start with ir4q_live_ and are shown once.

  3. 3
    Call the API

    Send Authorization: Bearer <key> to https://api.ir4q.com.

curl https://api.ir4q.com/v1/employer-api/jobs \
  -H "Authorization: Bearer ir4q_live_..."

Employer API

Developer plan
GET/v1/employer-api/jobsList your company's jobs
POST/v1/employer-api/jobsCreate a job (title, description, location, employment_type, remote_policy, salary_min, salary_max, salary_currency)
GET/v1/employer-api/jobs/{id}One job
PATCH/v1/employer-api/jobs/{id}Update a job
POST/v1/employer-api/jobs/{id}/closeClose a job
GET/v1/employer-api/applicationsApplications to your jobs
GET/v1/employer-api/applications/{id}One application

Every job created through the API takes applications on IR4Q. Outside apply links and email addresses are not used. Webhooks for new applications are set up in Developer.

MCP server for AI agents

Connect Claude or any MCP client to https://mcp.ir4q.com/mcp with the same Bearer key. Tools include:

search_jobsget_joblist_categorieslist_locationslist_companiesget_companyplatform_stats

The full machine-readable reference is at https://api.ir4q.com/openapi.json (send your key).

Questions about the API?

Open a support ticket from your dashboard. We answer inside IR4Q.