{"openapi":"3.1.0","info":{"title":"Job Sentinel API","description":"API for job search and sentinel creation","version":"1.0.0"},"paths":{"/api/v1/departments":{"get":{"tags":["Search Reference Data"],"summary":"Departments","description":"List accepted department values, optionally filtered by name. No credit charge.","operationId":"departments_api_v1_departments_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DepartmentResponse"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"Account or reference data temporarily unavailable.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/job-boards":{"get":{"tags":["Search Reference Data"],"summary":"Job Boards","description":"List accepted include/exclude job-board values. No credit charge.","operationId":"job_boards_api_v1_job_boards_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","maxLength":200,"default":"","title":"Q"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobBoardResponse"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"Account or reference data temporarily unavailable.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/credits/balance":{"get":{"tags":["Search Reference Data"],"summary":"Credit Balance","description":"Read the caller's current balance, including zero or negative balances.","operationId":"credit_balance_api_v1_credits_balance_get","responses":{"200":{"description":"Successful Response","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreditBalanceResponse"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"Account or reference data temporarily unavailable.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"text/plain":{"schema":{"type":"string"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}},"security":[{"HTTPBearer":[]}]}},"/api/v1/locations":{"get":{"tags":["Search Reference Data"],"summary":"Locations","description":"Autocomplete cities, states, and countries. Values can be used in jobs_locations.","operationId":"locations_api_v1_locations_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":3,"maxLength":200,"title":"Q"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":30,"minimum":1,"default":10,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LocationResponse"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"Account or reference data temporarily unavailable.","headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/jobs-search/search":{"post":{"tags":["Sentrion v2 - Direct Jobs"],"summary":"Search for jobs directly","description":"Search for jobs based on various criteria without company-specific validation. Requires an active API key. New jobs cost one credit each; previously paid jobs and empty results are available at zero or negative balance.","operationId":"direct_jobs_search_api_v1_jobs_search_search_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","title":"Idempotency-Key"},"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","example":"use_v1_0123456789abcdef0123456789abcdef"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__demo_api__schemas__DirectJobsRequest"}}}},"responses":{"200":{"description":"Complete settled search result, including zero-cost results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v1__direct_jobs__schemas__response__DirectSearchResponse"}}},"headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"400":{"description":"Invalid Idempotency-Key or request identity.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"402":{"description":"The complete new-job result is unaffordable; no jobs were delivered or charged.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"409":{"description":"The operation key has changed request intent or its billing period has expired.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Rate limit exceeded; nothing was delivered or charged. Retry with the same Idempotency-Key after Retry-After seconds.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"service_unavailable: the search or service is temporarily unavailable and nothing was charged; retry with the same Idempotency-Key. invalid_result: the complete result cannot be stored within the 4 MiB snapshot limit.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/company-jobs/search":{"post":{"tags":["Sentrion v2 - Company Jobs v1"],"summary":"Search for company jobs (v1)","description":"Search for jobs at specific companies with internal API enrichment. Requires an active API key. New jobs cost one credit each; previously paid jobs and empty results are available at zero or negative balance.","operationId":"company_jobs_search_api_v1_company_jobs_search_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","title":"Idempotency-Key"},"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","example":"use_v1_0123456789abcdef0123456789abcdef"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v1__company_jobs__schemas__request__CompanyJobsRequest"}}}},"responses":{"200":{"description":"Complete settled search result, including zero-cost results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v1__company_jobs__schemas__response__SearchCompanyJobsResponse"}}},"headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"400":{"description":"Missing required company LinkedIn URL, invalid job board, or invalid Idempotency-Key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"402":{"description":"The complete new-job result is unaffordable; no jobs were delivered or charged.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"409":{"description":"The operation key has changed request intent or its billing period has expired.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Rate limit exceeded; nothing was delivered or charged. Retry with the same Idempotency-Key after Retry-After seconds.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"service_unavailable: the search or service is temporarily unavailable and nothing was charged; retry with the same Idempotency-Key. invalid_result: the complete result cannot be stored within the 4 MiB snapshot limit.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/jobs-search/historical/search":{"post":{"tags":["Historical Jobs Search"],"summary":"Search for jobs directly (historical)","description":"Search historical job postings. Available to every active API key. New jobs cost two credits each; previously paid jobs and empty results are available at zero or negative balance.","operationId":"direct_jobs_search_api_v1_jobs_search_historical_search_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","title":"Idempotency-Key"},"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","example":"use_v1_0123456789abcdef0123456789abcdef"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/api__demo_api__v3__schemas__DirectJobsRequest"}}}},"responses":{"200":{"description":"Complete settled search result, including zero-cost results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v3__direct_jobs__schemas__response__DirectSearchResponse"}}},"headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"400":{"description":"Invalid Idempotency-Key or request identity.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"402":{"description":"The complete new-job result is unaffordable; no jobs were delivered or charged.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"409":{"description":"The operation key has changed request intent or its billing period has expired.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Rate limit exceeded; nothing was delivered or charged. Retry with the same Idempotency-Key after Retry-After seconds.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"service_unavailable: the search or service is temporarily unavailable and nothing was charged; retry with the same Idempotency-Key. invalid_result: the complete result cannot be stored within the 4 MiB snapshot limit.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}},"/api/v1/company-jobs/historical/search":{"post":{"tags":["Historical Company Jobs"],"summary":"Search for company jobs (historical)","description":"Search historical job postings at specific companies. Available to every active API key. New jobs cost two credits each; previously paid jobs and empty results are available at zero or negative balance.","operationId":"company_jobs_search_api_v1_company_jobs_historical_search_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","title":"Idempotency-Key"},"description":"Optional stable retry key: use_v1_ followed by 1–121 ASCII letters, digits, underscores, or hyphens. Invalid keys return 400.","example":"use_v1_0123456789abcdef0123456789abcdef"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v3__company_jobs__schemas__request__CompanyJobsRequest"}}}},"responses":{"200":{"description":"Complete settled search result, including zero-cost results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Sentrion_v2__api__v3__company_jobs__schemas__response__SearchCompanyJobsResponse"}}},"headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"400":{"description":"Missing required company LinkedIn URL, invalid job board, or invalid Idempotency-Key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"402":{"description":"The complete new-job result is unaffordable; no jobs were delivered or charged.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"403":{"description":"Missing, invalid, or inactive API key.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"409":{"description":"The operation key has changed request intent or its billing period has expired.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"429":{"description":"Rate limit exceeded; nothing was delivered or charged. Retry with the same Idempotency-Key after Retry-After seconds.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"503":{"description":"service_unavailable: the search or service is temporarily unavailable and nothing was charged; retry with the same Idempotency-Key. invalid_result: the complete result cannot be stored within the 4 MiB snapshot limit.","headers":{"Idempotency-Key":{"description":"Effective operation key. Reuse a caller-supplied key to recover a lost response within the billing period.","schema":{"type":"string"}},"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPErrorResponse"}}}},"500":{"description":"Unexpected server error.","content":{"text/plain":{"schema":{"type":"string"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"headers":{"X-Request-ID":{"description":"Server-generated UUID for this HTTP attempt; separate from the billing operation key.","schema":{"type":"string","format":"uuid"}}}}}}}},"components":{"schemas":{"AddressDetails":{"properties":{"address_line1":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line1"},"address_line2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Address Line2"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"is_headquarters":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Headquarters"}},"type":"object","title":"AddressDetails"},"AdvancedFilterGroup":{"properties":{"mode":{"type":"string","enum":["and","or"],"title":"Mode","description":"'and' or 'or' logic for combining title, description, and nested groups","default":"and"},"title":{"anyOf":[{"$ref":"#/components/schemas/TermGroup"},{"type":"null"}],"description":"Title keywords with their own logic"},"description":{"anyOf":[{"$ref":"#/components/schemas/TermGroup"},{"type":"null"}],"description":"Description keywords with their own logic"},"groups":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Groups","description":"Nested groups of filters"}},"type":"object","title":"AdvancedFilterGroup","description":"Recursive structure for advanced boolean logic filtering."},"CompanyJobKeywords":{"properties":{"mode":{"type":"string","enum":["and","or"],"title":"Mode","description":"'and' for must, 'or' for should logic between title and description","default":"and"},"title":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Title","description":"Search terms for job title"},"description":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Description","description":"Search terms for job description"}},"type":"object","title":"CompanyJobKeywords"},"CreditBalanceResponse":{"properties":{"credits_remaining":{"type":"integer","title":"Credits Remaining"},"plan_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Type","description":"Stored plan name; does not imply a credit allowance."},"billing_date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Billing Date","description":"Billing-cycle anchor used for duplicate-charge protection, not a credit expiry date."}},"type":"object","required":["credits_remaining"],"title":"CreditBalanceResponse"},"DepartmentResponse":{"properties":{"departments":{"items":{"$ref":"#/components/schemas/FilterOption"},"type":"array","title":"Departments"}},"type":"object","required":["departments"],"title":"DepartmentResponse"},"EmployeeStats":{"properties":{"headcount":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Headcount"},"size_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Size Range"}},"type":"object","title":"EmployeeStats"},"ExcludeCompanyJobKeywords":{"properties":{"mode":{"type":"string","enum":["and","or"],"title":"Mode","description":"'and' for all keywords to be excluded, 'or' for any keyword to be excluded","default":"and"},"title":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Title","description":"Keywords to exclude from job titles"},"description":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Description","description":"Keywords to exclude from job descriptions"}},"type":"object","title":"ExcludeCompanyJobKeywords"},"FilterOption":{"properties":{"label":{"type":"string","title":"Label"},"value":{"type":"string","title":"Value"}},"type":"object","required":["label","value"],"title":"FilterOption"},"FoundingDate":{"properties":{"day":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Day"},"month":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Month"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Year"}},"type":"object","title":"FoundingDate"},"HTTPErrorResponse":{"properties":{"detail":{"type":"string","title":"Detail"}},"type":"object","required":["detail"],"title":"HTTPErrorResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"InferredSeniorityLevel":{"type":"string","enum":["Entry Level","Mid Level","Executive Level"],"title":"InferredSeniorityLevel","description":"Inferred seniority level enumeration."},"JobBoardResponse":{"properties":{"job_boards":{"items":{"$ref":"#/components/schemas/FilterOption"},"type":"array","title":"Job Boards"}},"type":"object","required":["job_boards"],"title":"JobBoardResponse"},"JobType":{"type":"string","enum":["Full Time","Part Time","Contract","Internship","Volunteer"],"title":"JobType","description":"Job type enumeration."},"LocationItem":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},"type":"object","title":"LocationItem","description":"Represents a single location with hierarchical structure."},"LocationOption":{"properties":{"label":{"type":"string","title":"Label"},"value":{"$ref":"#/components/schemas/LocationValue"}},"type":"object","required":["label","value"],"title":"LocationOption"},"LocationResponse":{"properties":{"locations":{"items":{"$ref":"#/components/schemas/LocationOption"},"type":"array","title":"Locations"}},"type":"object","required":["locations"],"title":"LocationResponse"},"LocationValue":{"properties":{"country":{"type":"string","title":"Country"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"}},"type":"object","required":["country"],"title":"LocationValue"},"NewDepartment":{"type":"string","enum":["Accounting","Administration","Arts and Design","Business Development","Communications","Community and Social Services","Compliance","Corporate Affairs","Corporate Strategy","Customer Experience","Customer Success","Customer Support","Data Analytics","Design","Education","Engineering","Facilities Management","Finance","Government Relations","Healthcare Services","Human Resources","Information Technology","Legal","Marketing","Operations","Product Management","Project Management","Public Relations","Purchasing","Quality Assurance","Real Estate","Research","Sales","Security","Software Engineering","Supply Chain","Support","Web Development"],"title":"NewDepartment"},"RawJobClean":{"properties":{"Job Type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type"},"Job Title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"Apply URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apply Url"},"Post Date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Date"},"Valid Through":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Through"},"City":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"Job Board":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Board"},"Job Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Description"},"Country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"Company Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"State":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"Salary Offered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Offered"},"Logo URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"Is Remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"Job URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Url"},"Department Name":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Department Name"},"Seniority Level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"Salary Currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Currency"},"Salary To":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salary To"},"Salary From":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salary From"},"Skills":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Skills"},"additional_data":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Additional Data"}},"type":"object","title":"RawJobClean","description":"Job model that hides internal fields from API responses."},"RawJobCleanV3":{"properties":{"Job Type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Type"},"Job Title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"Apply URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Apply Url"},"Post Date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Post Date"},"Valid Through":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Valid Through"},"City":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"Job Board":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Board"},"Job Description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Description"},"Country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"Company Name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"State":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"},"Salary Offered":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Offered"},"Logo URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Logo Url"},"Is Remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"Job URL":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Url"},"Department Name":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Department Name"},"Seniority Level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"Salary Currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Salary Currency"},"Salary To":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salary To"},"Salary From":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Salary From"},"Skills":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Skills"}},"type":"object","title":"RawJobCleanV3","description":"Job model that hides internal fields from API responses (v3)."},"Sentrion_v2__api__v1__company_jobs__schemas__request__CompanyJobsRequest":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_broad_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Broad Search","default":false},"jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Jobs Locations"},"exclude_jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Exclude Jobs Locations","description":"List of structured location objects to exclude from search with country/state/city hierarchy"},"published_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Before","description":"End date for job search in yyyy-mm-dd format"},"published_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published After","description":"Start date for job search in yyyy-mm-dd format"},"department":{"anyOf":[{"items":{"$ref":"#/components/schemas/NewDepartment"},"type":"array"},{"type":"null"}],"title":"Department"},"job_keywords":{"anyOf":[{"$ref":"#/components/schemas/CompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for job keywords search with separate fields for title and description keywords"},"exclude_job_keywords":{"anyOf":[{"$ref":"#/components/schemas/ExcludeCompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for excluding job keywords with separate fields for title and description keywords"},"job_type":{"anyOf":[{"items":{"$ref":"#/components/schemas/JobType"},"type":"array"},{"type":"null"}],"title":"Job Type","description":"Type of the advertised job. Extracted as Full Time, Part Time, Contract, Internship or Volunteer"},"seniority_level":{"anyOf":[{"items":{"$ref":"#/components/schemas/InferredSeniorityLevel"},"type":"array"},{"type":"null"}],"title":"Seniority Level","description":"Expected seniority level requirement of the job. System generated field using a machine learning model. Available only for jobs published in English. Possible values: Entry Level, Mid Level, Executive Level"},"advanced_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Job Keywords","description":"List of advanced keyword groups with nested boolean logic. Top level is implicit AND."},"advanced_exclude_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Exclude Job Keywords","description":"List of advanced exclusion groups with nested boolean logic. Top level is implicit AND."},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"is_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Agency","description":"Ignored for company-scoped searches — the specified company defines the result set. (This filter applies only to keyword/direct job searches.)"},"salary_data_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Salary Data Available","description":"Filter for jobs with valid salary data (inferred_salary_from exists and is not 0)"},"country_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Country Exists","description":"Filter for jobs that have country information (country or inferred_country fields exist)"},"exclude_duplicates":{"type":"boolean","title":"Exclude Duplicates","default":true},"job_boards":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Boards"},"limit":{"type":"integer","maximum":20000.0,"minimum":1.0,"title":"Limit","description":"Max results (1-20000)","default":100},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"},"exclude_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Job Boards"},"include_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Job Boards"}},"type":"object","required":["company_linkedin_url"],"title":"CompanyJobsRequest"},"Sentrion_v2__api__v1__company_jobs__schemas__response__RawJobResponse":{"properties":{"company_details":{"anyOf":[{"$ref":"#/components/schemas/TransformedCompanyProfile"},{"type":"null"}],"description":"Company details"},"jobs":{"items":{"$ref":"#/components/schemas/RawJobClean"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total"},"total_jobs_found":{"type":"integer","title":"Total Jobs Found","description":"Integer of the integer total with a '+' at the end, e.g., '170+'"},"credits_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Used","description":"Number of credits consumed for this search"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Number of credits remaining after this search"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","required":["jobs","total","total_jobs_found"],"title":"RawJobResponse","description":"Job response payload using clean job models."},"Sentrion_v2__api__v1__company_jobs__schemas__response__SearchCompanyJobsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/Sentrion_v2__api__v1__company_jobs__schemas__response__RawJobResponse"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if success is false"}},"type":"object","required":["data"],"title":"SearchCompanyJobsResponse","description":"Top-level company jobs response using clean data payload."},"Sentrion_v2__api__v1__direct_jobs__schemas__response__DirectSearchJobData":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/RawJobClean"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total","description":"Number of jobs returned in this response batch."},"total_jobs_found":{"type":"integer","title":"Total Jobs Found","description":"Total number of jobs found matching the criteria."},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","required":["jobs","total","total_jobs_found","credits_used"],"title":"DirectSearchJobData","description":"Direct search data payload using clean job models."},"Sentrion_v2__api__v1__direct_jobs__schemas__response__DirectSearchResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/Sentrion_v2__api__v1__direct_jobs__schemas__response__DirectSearchJobData"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","data"],"title":"DirectSearchResponse","description":"Top-level direct search response using clean data payload."},"Sentrion_v2__api__v3__company_jobs__schemas__request__CompanyJobsRequest":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_broad_search":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Company Broad Search","default":false},"jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Jobs Locations"},"exclude_jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Exclude Jobs Locations","description":"List of structured location objects to exclude from search with country/state/city hierarchy"},"published_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Before","description":"End date in yyyy-mm-dd format. Defaults to the current UTC time; must be later than published_after."},"published_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published After","description":"Start date in yyyy-mm-dd format. Defaults to the rolling 83-month floor with a one-day safety margin; earlier dates are rejected."},"department":{"anyOf":[{"items":{"$ref":"#/components/schemas/NewDepartment"},"type":"array"},{"type":"null"}],"title":"Department"},"job_keywords":{"anyOf":[{"$ref":"#/components/schemas/CompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for job keywords search with separate fields for title and description keywords"},"exclude_job_keywords":{"anyOf":[{"$ref":"#/components/schemas/ExcludeCompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for excluding job keywords with separate fields for title and description keywords"},"job_type":{"anyOf":[{"items":{"$ref":"#/components/schemas/JobType"},"type":"array"},{"type":"null"}],"title":"Job Type","description":"Type of the advertised job. Extracted as Full Time, Part Time, Contract, Internship or Volunteer"},"seniority_level":{"anyOf":[{"items":{"$ref":"#/components/schemas/InferredSeniorityLevel"},"type":"array"},{"type":"null"}],"title":"Seniority Level","description":"Expected seniority level requirement of the job. System generated field using a machine learning model. Available only for jobs published in English. Possible values: Entry Level, Mid Level, Executive Level"},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"is_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Agency","description":"Ignored for company-scoped searches — the specified company defines the result set. (This filter applies only to keyword/direct job searches.)"},"salary_data_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Salary Data Available","description":"Filter for jobs with valid salary data (inferred_salary_from exists and is not 0). False, omitted or null: no salary filter."},"country_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Country Exists","description":"Filter for jobs that have country information (country or inferred_country fields exist)"},"advanced_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Job Keywords","description":"List of advanced keyword groups with nested boolean logic. Top level is implicit AND."},"advanced_exclude_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Exclude Job Keywords","description":"List of advanced exclusion groups with nested boolean logic. Top level is implicit AND."},"exclude_duplicates":{"type":"boolean","title":"Exclude Duplicates","default":true},"job_boards":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Boards"},"limit":{"type":"integer","maximum":20000.0,"minimum":1.0,"title":"Limit","description":"Max results (1-20000)","default":100},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"},"exclude_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Job Boards"},"include_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Job Boards"}},"type":"object","required":["company_linkedin_url"],"title":"CompanyJobsRequest"},"Sentrion_v2__api__v3__company_jobs__schemas__response__RawJobResponse":{"properties":{"company_details":{"anyOf":[{"$ref":"#/components/schemas/TransformedCompanyProfile"},{"type":"null"}],"description":"Company details"},"jobs":{"items":{"$ref":"#/components/schemas/RawJobCleanV3"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total"},"total_jobs_found":{"type":"integer","title":"Total Jobs Found","description":"Integer of the integer total with a '+' at the end, e.g., '170+'"},"credits_used":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Used","description":"Number of credits consumed for this search"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining","description":"Number of credits remaining after this search"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","required":["jobs","total","total_jobs_found"],"title":"RawJobResponse","description":"Job response payload using clean job models (v3)."},"Sentrion_v2__api__v3__company_jobs__schemas__response__SearchCompanyJobsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"data":{"$ref":"#/components/schemas/Sentrion_v2__api__v3__company_jobs__schemas__response__RawJobResponse"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error","description":"Error message if success is false"}},"type":"object","required":["data"],"title":"SearchCompanyJobsResponse","description":"Top-level company jobs response using clean data payload (v3)."},"Sentrion_v2__api__v3__direct_jobs__schemas__response__DirectSearchJobData":{"properties":{"jobs":{"items":{"$ref":"#/components/schemas/RawJobCleanV3"},"type":"array","title":"Jobs"},"total":{"type":"integer","title":"Total","description":"Number of jobs returned in this response batch."},"total_jobs_found":{"type":"integer","title":"Total Jobs Found","description":"Total number of jobs found matching the criteria."},"credits_used":{"type":"integer","title":"Credits Used"},"credits_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Credits Remaining"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","required":["jobs","total","total_jobs_found","credits_used"],"title":"DirectSearchJobData","description":"Direct search data payload using clean job models (v3)."},"Sentrion_v2__api__v3__direct_jobs__schemas__response__DirectSearchResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"data":{"$ref":"#/components/schemas/Sentrion_v2__api__v3__direct_jobs__schemas__response__DirectSearchJobData"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"type":"object","required":["success","data"],"title":"DirectSearchResponse","description":"Top-level direct search response using clean data payload (v3)."},"TermGroup":{"properties":{"mode":{"type":"string","enum":["and","or"],"title":"Mode","description":"'and' or 'or' logic for the terms","default":"or"},"terms":{"items":{"type":"string"},"type":"array","title":"Terms","description":"List of keywords"}},"type":"object","required":["terms"],"title":"TermGroup","description":"Group of terms with a specific boolean mode."},"TransformedCompanyProfile":{"properties":{"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry"},"employee_data":{"anyOf":[{"$ref":"#/components/schemas/EmployeeStats"},{"type":"null"}]},"website":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Website"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/AddressDetails"},"type":"array"},{"type":"null"}],"title":"Locations"},"founded_date":{"anyOf":[{"$ref":"#/components/schemas/FoundingDate"},{"type":"null"}]},"tagline":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tagline"},"specialties":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Specialties"}},"type":"object","title":"TransformedCompanyProfile"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"api__demo_api__schemas__DirectJobsRequest":{"properties":{"jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Jobs Locations"},"exclude_jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Exclude Jobs Locations","description":"List of structured location objects to exclude from search with country/state/city hierarchy"},"published_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Before","description":"End date for job search in yyyy-mm-dd format"},"published_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published After","description":"Start date for job search in yyyy-mm-dd format"},"department":{"anyOf":[{"items":{"$ref":"#/components/schemas/NewDepartment"},"type":"array"},{"type":"null"}],"title":"Department"},"industry":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Industry","description":"List of industries to filter jobs by."},"job_keywords":{"anyOf":[{"$ref":"#/components/schemas/CompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for job keywords search with separate fields for title and description keywords"},"exclude_job_keywords":{"anyOf":[{"$ref":"#/components/schemas/ExcludeCompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for excluding job keywords with separate fields for title and description keywords"},"advanced_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Job Keywords","description":"List of advanced keyword groups with nested boolean logic. Top level is implicit AND."},"advanced_exclude_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Exclude Job Keywords","description":"List of advanced exclusion groups with nested boolean logic. Top level is implicit AND."},"job_type":{"anyOf":[{"items":{"$ref":"#/components/schemas/JobType"},"type":"array"},{"type":"null"}],"title":"Job Type","description":"Type of the advertised job. Extracted as Full Time, Part Time, Contract, Internship or Volunteer"},"seniority_level":{"anyOf":[{"items":{"$ref":"#/components/schemas/InferredSeniorityLevel"},"type":"array"},{"type":"null"}],"title":"Seniority Level","description":"Expected seniority level requirement of the job. System generated field using a machine learning model. Available only for jobs published in English. Possible values: Entry Level, Mid Level, Executive Level"},"exclude_duplicates":{"type":"boolean","title":"Exclude Duplicates","default":true},"job_boards":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Boards"},"exclude_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Job Boards"},"include_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Job Boards"},"limit":{"type":"integer","maximum":20000.0,"minimum":1.0,"title":"Limit","description":"Max results (1-20000)","default":100},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"is_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Agency","description":"Recruiting-agency filter. false: exclude jobs posted by known recruiting agencies (jobs from unclassified employers are kept). true: return only jobs posted by known recruiting agencies. Omit or null: no filter."},"salary_data_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Salary Data Available","description":"Filter for jobs with valid salary data (inferred_salary_from exists and is not 0)"},"country_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Country Exists","description":"Filter for jobs that have country information (country or inferred_country fields exist)"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","title":"DirectJobsRequest","description":"Request schema for direct jobs search endpoint without company-specific validation."},"api__demo_api__v3__schemas__DirectJobsRequest":{"properties":{"jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Jobs Locations"},"exclude_jobs_locations":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocationItem"},"type":"array"},{"type":"null"}],"title":"Exclude Jobs Locations","description":"List of structured location objects to exclude from search with country/state/city hierarchy"},"published_before":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published Before","description":"End date in yyyy-mm-dd format. Defaults to the current UTC time; must be later than published_after."},"published_after":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Published After","description":"Start date in yyyy-mm-dd format. Defaults to the rolling 83-month floor with a one-day safety margin; earlier dates are rejected."},"department":{"anyOf":[{"items":{"$ref":"#/components/schemas/NewDepartment"},"type":"array"},{"type":"null"}],"title":"Department"},"industry":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Industry","description":"List of industries to filter jobs by."},"job_keywords":{"anyOf":[{"$ref":"#/components/schemas/CompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for job keywords search with separate fields for title and description keywords"},"exclude_job_keywords":{"anyOf":[{"$ref":"#/components/schemas/ExcludeCompanyJobKeywords"},{"type":"null"}],"description":"Nested structure for excluding job keywords with separate fields for title and description keywords"},"job_type":{"anyOf":[{"items":{"$ref":"#/components/schemas/JobType"},"type":"array"},{"type":"null"}],"title":"Job Type","description":"Type of the advertised job. Extracted as Full Time, Part Time, Contract, Internship or Volunteer"},"seniority_level":{"anyOf":[{"items":{"$ref":"#/components/schemas/InferredSeniorityLevel"},"type":"array"},{"type":"null"}],"title":"Seniority Level","description":"Expected seniority level requirement of the job. System generated field using a machine learning model. Available only for jobs published in English. Possible values: Entry Level, Mid Level, Executive Level"},"advanced_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Job Keywords","description":"List of advanced keyword groups with nested boolean logic. Top level is implicit AND."},"advanced_exclude_job_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/AdvancedFilterGroup"},"type":"array"},{"type":"null"}],"title":"Advanced Exclude Job Keywords","description":"List of advanced exclusion groups with nested boolean logic. Top level is implicit AND."},"exclude_duplicates":{"type":"boolean","title":"Exclude Duplicates","default":true},"job_boards":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Job Boards"},"exclude_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Exclude Job Boards"},"include_job_boards":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Include Job Boards"},"limit":{"type":"integer","maximum":20000.0,"minimum":1.0,"title":"Limit","description":"Max results (1-20000)","default":100},"is_remote":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Remote"},"is_agency":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Agency","description":"Recruiting-agency filter. false: exclude jobs posted by known recruiting agencies (jobs from unclassified employers are kept). true: return only jobs posted by known recruiting agencies. Omit or null: no filter."},"salary_data_available":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Salary Data Available","description":"Filter for jobs with valid salary data (inferred_salary_from exists and is not 0). False, omitted or null: no salary filter."},"country_exists":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Country Exists","description":"Filter for jobs that have country information (country or inferred_country fields exist)"},"search_after":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Search After","description":"Search after values for pagination - array of [timestamp, cursor_id]"}},"type":"object","title":"DirectJobsRequest","description":"Request schema for direct jobs search endpoint without company-specific validation."}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}