Skip to main content
All API endpoints require authentication. Get your API key from your JobHive dashboard under Settings → API Keys.

​
Welcome to JobHive API

The JobHive API provides complete access to our AI-powered interview platform. Build custom integrations, automate your hiring workflows, and access real-time interview data. JobHive API Architecture - REST endpoints, WebSocket connections, authentication flow, and integration patterns

Quick Start

Get up and running in minutes

Authentication

Learn about API authentication

Rate Limits

Understand API usage limits

Webhooks

Real-time event notifications

​
Base URL

All API requests should be made to: 
https://backend.jobhive.ai/v1

​
Authentication

All API endpoints require authentication using Bearer tokens. Include your API key in the Authorization header: 
curl -X GET "https://backend.jobhive.ai/v1/interviews" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

​
API Key Management

  • Generate API keys from your JobHive dashboard
  • Use different keys for development and production
  • Rotate keys regularly for security
  • Never expose API keys in client-side code

​
Rate Limits

JobHive enforces rate limits based on your subscription plan:
PlanRequests/minBurst LimitMonthly Quota
Free6010010,000
Professional300500100,000
Enterprise1,0002,000Unlimited

​
Rate Limit Headers

API responses include rate limit information: 
X-RateLimit-Limit: 300
X-RateLimit-Remaining: 299
X-RateLimit-Reset: 1640995200

​
Response Format

All API responses use consistent JSON formatting: 
{
  "success": true,
  "data": {
    // Response data
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_abc123"
  }
}

​
Error Responses

Error responses include detailed information: 
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email format",
    "details": {
      "field": "candidate_email",
      "value": "invalid-email"
    }
  },
  "meta": {
    "timestamp": "2024-01-15T10:30:00Z",
    "request_id": "req_abc123"
  }
}

​
HTTP Status Codes

CodeDescription
200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
429Too Many Requests
500Internal Server Error

​
Pagination

List endpoints support cursor-based pagination: 
{
  "data": [...],
  "pagination": {
    "next_cursor": "eyJpZCI6MTIzfQ==",
    "has_more": true,
    "total_count": 150
  }
}
Use the cursor parameter for pagination: 
curl "https://backend.jobhive.ai/v1/interviews?cursor=eyJpZCI6MTIzfQ=="

​
Integration Examples

JavaScript/Node.js

Direct API integration with axios and fetch

Python

Requests library with async patterns

cURL Examples

Ready-to-use command examples
API Integration Examples - Code snippets showing JavaScript, Python, and cURL implementations for common API operations

​
Support

Need help with the API? We’re here to assist:
Use test mode for development to avoid consuming production credits. Add "test_mode": true to your requests.