⚡ HireDora Developer Hub

Integrate automated candidate parsing, vector semantic search, and AI-powered recruitment workflows directly into your applications using our REST API.

API Status: Operational (v2.4)

🚀 Authentication

All REST API requests require a Bearer Token supplied in the HTTP Authorization header.

HTTP Header

Authorization: Bearer hd_live_your_api_key_here

🔍 Semantic Vector Search

Execute similarity search across stored candidate CV embeddings using cosine distance.

POST /api/v2/candidates/search

JSON Payload

{
  "query": "Senior Java Tomcat Developer",
  "top_k": 5,
  "min_score": 0.82
}

📦 Core API Endpoints Overview

GET /api/v2/applications

Fetch paginated list of candidate applications

POST /api/v2/applications/ingest

Parse resume document (PDF, Word, Image) & extract vectors

DELETE /api/v2/applications/{id}

Permanently purge applicant data for compliance

☕ Java SDK (Maven)

Official client library optimized for Apache Tomcat & Spring applications.

pom.xml

<dependency>
  <groupId>com.hiredora</groupId>
  <artifactId>hiredora-java-sdk</artifactId>
  <version>2.4.0</version>
</dependency>

🐍 Python SDK

Designed for fast AI/ML pipeline integration and candidate batch processing.

Terminal

pip install hiredora-sdk

🔔 Real-time Webhook Events

Subscribe your HTTP endpoints to receive asynchronous events when candidates apply or when AI screening completes.

candidate.applied Triggered immediately after new CV upload

screening.completed Triggered when Ollama AI finishes CV summary

Sample Webhook Event Body

{
  "event": "screening.completed",
  "application_id": 4470,
  "candidate_email": "applicant@example.com",
  "match_score": 0.94,
  "timestamp": "2026-09-23T23:35:00Z"
}

🔑 API Key Generator Sandbox

Generate a live sandbox API key to begin building integrations with HireDora services.