HiringCenter Pro API

URI: https://api.hiringcenterpro.com/v2

---

Authentication

Create an API Key (Video)

The HiringCenter Pro API uses Bearer Token authentication for all requests. Add your API Key to the Authorization header for each request.

• Authorization Header:

  Code
   
  {
    "Authorization": "Bearer <<YOUR_API_KEY>>"
  }

API keys are hashed and stored securely. Each key is associated with an account and contains specific permissions.

Example Requests

• List prospects

  Code
   
  curl -X GET \
    'https://api.hiringcenterpro.com/v2/prospects?limit=1' \
    -H 'Authorization: Bearer <YOUR_API_KEY>' \
    -H 'Accept: application/json'

• Create a prospect

  Code
   
  curl -X POST \
    'https://api.hiringcenterpro.com/v2/prospects' \
    -H 'Authorization: Bearer <YOUR_API_KEY>' \
    -H 'Content-Type: application/json' \
    -d '{
      "firstName": "Jane",
      "lastName": "Doe"
    }'

Rate Limiting

The API implements rate limiting to ensure system stability and fair usage. Rate limits are applied per authentication token.

Rate Limit Windows

The API currently enforces two simultaneous rate-limit windows:

Window	Duration	Request Limit
Minute	60s	1,200 requests
Hour	3,600s	5,400 requests

Rate Limit Headers

Each response includes rate limit information headers:

• RateLimit-Limit: Maximum requests allowed in the current window (minute)
• RateLimit-Remaining: Remaining requests in the current window (minute)
• RateLimit-Reset: Unix timestamp when the rate limit window resets

Rate Limit Exceeded Response

When a rate limit is exceeded, the API returns:

• Status Code: 429 Too Many Requests
• Response Body:

  Code
   
  {
    "error": "Too many requests",
    "message": "Minute/Hour limit exceeded. Please try again later.",
    "retryAfter": 30
  }

• Headers:
  • Retry-After: Number of seconds to wait before retrying