{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Authentication & API Keys","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"authentication--api-keys","__idx":0},"children":["Authentication & API Keys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Hunty's API supports two authentication mechanisms. All requests must include at least one."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"bearer-token-jwt","__idx":1},"children":["Bearer Token (JWT)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Used for requests made on behalf of an authenticated user session."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the token in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Authorization"]}," header:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"Authorization: Bearer <your_jwt_token>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-key--x-auth-api-key-","__idx":2},"children":["API Key (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-auth-api-key"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Used for server-to-server integrations. The API key is tied to a specific company and grants access to the endpoints explicitly approved during the request process."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Include the key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["x-auth-api-key"]}," header:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"x-auth-api-key: <your_api_key>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"rate-limits","__idx":3},"children":["Rate Limits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["API keys are subject to a rate limit of ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["25 requests per minute"]},". Exceeding this limit returns an HTTP ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["429 Too Many Requests"]}," response. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/rate-limits"},"children":["Rate Limits"]}," page for guidance on handling this."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requesting-an-api-key","__idx":4},"children":["Requesting an API Key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To request an API Key for your company, send an email with the following details:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["To:"]}," comite-seguridad@hunty.com"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["CC:"]}," santiago@hunty.com, enzo.garcia@hunty.com"," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Subject:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Solicitud API Key - <companyId>"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body must include:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company and responsible contact"]}," — company name, full name, role, and email of the person responsible for the integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List of endpoints"]}," — for each endpoint your integration needs access to, include:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The endpoint path and HTTP method (e.g., ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v2/vacancies/company/{companyId}"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A brief justification of the use case"]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Example email body:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Hi,\n\nWe would like to request an API Key for the following company:\n\nCompany: Acme Corp\nResponsible contact: Jane Doe, Integration Lead — jane.doe@acmecorp.com\n\nEndpoints requested:\n\n1. GET /v2/vacancies/company/{companyId}\n   Use case: Retrieve the list of active vacancies for our company to sync with our internal ATS.\n\n2. POST /v2/vacancies/{vacancyId}/applications\n   Use case: Submit candidate applications directly from our recruitment platform.\n\nThank you.\n"},"children":[]}]},"headings":[{"value":"Authentication & API Keys","id":"authentication--api-keys","depth":1},{"value":"Bearer Token (JWT)","id":"bearer-token-jwt","depth":2},{"value":"API Key ( x-auth-api-key )","id":"api-key--x-auth-api-key-","depth":2},{"value":"Rate Limits","id":"rate-limits","depth":2},{"value":"Requesting an API Key","id":"requesting-an-api-key","depth":2}],"frontmatter":{"seo":{"title":"Authentication & API Keys"}},"lastModified":"2026-04-20T20:17:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}