{
  "info": {
    "name": "Recruitizr Open API v1",
    "description": "Public REST API for Recruitizr — manage positions, candidates, interviews, and companies in your tenant. Authenticate with an API key created at /integrations inside your Recruitizr admin console.\n\nDocs: https://recruitizr.ai/developers",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "rkz-open-api-v1"
  },
  "auth": {
    "type": "bearer",
    "bearer": [{ "key": "token", "value": "{{API_KEY}}", "type": "string" }]
  },
  "variable": [
    { "key": "BASE_URL", "value": "https://recruitizr.ai", "type": "string" },
    { "key": "API_KEY", "value": "rk_live_REPLACE_ME", "type": "string" }
  ],
  "item": [
    {
      "name": "Verify key (GET /api/v1/me)",
      "request": {
        "method": "GET",
        "header": [],
        "url": { "raw": "{{BASE_URL}}/api/v1/me", "host": ["{{BASE_URL}}"], "path": ["api", "v1", "me"] },
        "description": "Quick sanity check — returns the tenant context for the API key. 401 if the key is missing, malformed, or revoked."
      }
    },
    {
      "name": "List positions",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{BASE_URL}}/api/v1/positions?limit=50&skip=0",
          "host": ["{{BASE_URL}}"], "path": ["api", "v1", "positions"],
          "query": [
            { "key": "limit", "value": "50" },
            { "key": "skip", "value": "0" },
            { "key": "status", "value": "open", "disabled": true }
          ]
        }
      }
    },
    {
      "name": "Create a position",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": { "raw": "{{BASE_URL}}/api/v1/positions", "host": ["{{BASE_URL}}"], "path": ["api", "v1", "positions"] },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"title\": \"Senior Backend Engineer\",\n  \"client_id\": \"COMPANY_UUID\",\n  \"location\": \"Bangalore, India\",\n  \"status\": \"open\",\n  \"num_openings\": 2,\n  \"job_description\": \"5+ yrs Python/FastAPI, MongoDB, AWS.\"\n}"
        }
      }
    },
    {
      "name": "List candidates",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{BASE_URL}}/api/v1/candidates?limit=50",
          "host": ["{{BASE_URL}}"], "path": ["api", "v1", "candidates"],
          "query": [
            { "key": "limit", "value": "50" },
            { "key": "skip", "value": "0" },
            { "key": "position_id", "value": "", "disabled": true },
            { "key": "email", "value": "", "disabled": true },
            { "key": "phone", "value": "", "disabled": true }
          ]
        }
      }
    },
    {
      "name": "Get a single candidate",
      "request": {
        "method": "GET",
        "url": { "raw": "{{BASE_URL}}/api/v1/candidates/CANDIDATE_UUID", "host": ["{{BASE_URL}}"], "path": ["api", "v1", "candidates", "CANDIDATE_UUID"] }
      }
    },
    {
      "name": "Create a candidate (fires candidate.created webhook)",
      "request": {
        "method": "POST",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "url": { "raw": "{{BASE_URL}}/api/v1/candidates", "host": ["{{BASE_URL}}"], "path": ["api", "v1", "candidates"] },
        "body": {
          "mode": "raw",
          "raw": "{\n  \"candidate_name\": \"Jane Doe\",\n  \"position_id\": \"POSITION_UUID\",\n  \"email\": \"jane@example.com\",\n  \"phone\": \"+91-9000000000\",\n  \"current_ctc\": 1800000,\n  \"expected_ctc\": 2400000,\n  \"notice_period_days\": 30,\n  \"source\": \"linkedin\",\n  \"status\": \"sent\"\n}"
        }
      }
    },
    {
      "name": "List interviews",
      "request": {
        "method": "GET",
        "url": {
          "raw": "{{BASE_URL}}/api/v1/interviews?limit=50",
          "host": ["{{BASE_URL}}"], "path": ["api", "v1", "interviews"],
          "query": [
            { "key": "limit", "value": "50" },
            { "key": "candidate_id", "value": "", "disabled": true },
            { "key": "status", "value": "", "disabled": true }
          ]
        }
      }
    },
    {
      "name": "List companies / clients",
      "request": {
        "method": "GET",
        "url": { "raw": "{{BASE_URL}}/api/v1/companies?limit=50", "host": ["{{BASE_URL}}"], "path": ["api", "v1", "companies"] }
      }
    }
  ]
}