API Documentation

Build custom integrations with the Recruit2 REST API. Access jobs, candidates, and applications programmatically.

Base URL: https://recruit.esirventures.com/api/v1

Quick Start

1

Get API Key

Generate an API key from your dashboard settings.

2

Authenticate

Include your JWT token in the Authorization header.

3

Make Requests

Start calling endpoints to manage your recruitment data.

Example Request
curl -X GET https://recruit.esirventures.com/api/v1/jobs \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json"

API Reference

Authentication

Learn how to authenticate with the Recruit2 API using JWT tokens.

POST/api/v1/auth/login
Authenticate and receive JWT token
POST/api/v1/auth/refresh
Refresh an expired token
POST/api/v1/auth/logout
Invalidate current session

Jobs

Create, update, and manage job postings.

GET/api/v1/jobs
List all jobs for your tenant
POST/api/v1/jobs
Create a new job posting
GET/api/v1/jobs/:id
Get job details
PATCH/api/v1/jobs/:id
Update a job posting
POST/api/v1/jobs/:id/publish
Publish a job

Candidates

Manage candidate profiles and applications.

GET/api/v1/candidates
List all candidates
POST/api/v1/candidates
Create a candidate
GET/api/v1/candidates/:id
Get candidate details
POST/api/v1/candidates/:id/resume
Upload resume

Applications

Track applications through your pipeline.

GET/api/v1/applications
List applications
POST/api/v1/applications
Create application
PATCH/api/v1/applications/:id/stage
Update stage
POST/api/v1/applications/:id/reject
Reject application

Rate Limits

API requests are rate limited based on your plan:

  • Starter:100 requests/minute
  • Professional:500 requests/minute
  • Enterprise:Custom limits

Error Codes

  • 400Bad Request - Invalid parameters
  • 401Unauthorized - Invalid token
  • 403Forbidden - Insufficient permissions
  • 404Not Found - Resource doesn't exist
  • 429Too Many Requests - Rate limited

SDKs Coming Soon

Official client libraries for popular programming languages are in development.

TypeScriptPythonRubyGo