API Introduction

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

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:

Plan	Requests/min	Burst Limit	Monthly Quota
Free	60	100	10,000
Professional	300	500	100,000
Enterprise	1,000	2,000	Unlimited

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

Code	Description
200	Success
201	Created
400	Bad Request
401	Unauthorized
403	Forbidden
404	Not Found
429	Too Many Requests
500	Internal 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:

Developer Support: exec@jobhive.ai
API Status: status.jobhive.ai

Use test mode for development to avoid consuming production credits. Add "test_mode": true to your requests.

Getting Started

Core Resources

Advanced Features

Welcome to JobHive API

Quick Start

Authentication

Rate Limits

Webhooks

Base URL

Authentication

API Key Management

Rate Limits

Rate Limit Headers

Response Format

Error Responses

HTTP Status Codes

Integration Examples

JavaScript/Node.js

Python

cURL Examples

Support

​Welcome to JobHive API

Quick Start

Authentication

Rate Limits

Webhooks

​Base URL

​Authentication

​API Key Management

​Rate Limits

​Rate Limit Headers

​Response Format

​Error Responses

​HTTP Status Codes

​Pagination

​Integration Examples

JavaScript/Node.js

Python

cURL Examples

​Support

Welcome to JobHive API

Base URL

Authentication

API Key Management

Rate Limits

Rate Limit Headers

Response Format

Error Responses

HTTP Status Codes

Pagination

Integration Examples

Support