> ## Documentation Index > Fetch the complete documentation index at: https://docs.instaview.sk/llms.txt > Use this file to discover all available pages before exploring further. # List Jobs > Lists jobs for the API key's company with pagination. Lists all job postings for the API key's company with pagination and filtering support. ## Overview The list jobs endpoint allows you to retrieve all job postings in your company. You can filter by status, search by title or description, and paginate through results. This is useful for managing your job pipeline and finding jobs before creating candidates. ## Use Cases * **Job Management**: Review all active job postings * **Status Filtering**: Find jobs by status (OPEN, CLOSED) * **Search**: Locate specific jobs by title or description * **Bulk Operations**: Retrieve jobs for bulk candidate assignment ## Basic Usage ```javascript theme={null} // List all jobs (first page, 20 items) GET /jobs ``` ## With Filters ```javascript theme={null} // Filter by status GET /jobs?status=OPEN // Search by title or description GET /jobs?search=engineer // Combine filters with pagination GET /jobs?status=OPEN&search=software&page=1&limit=50 ``` ## Company Scoping All returned jobs belong to your API key's company. ATS keys can filter by `companyId` to access jobs from specific companies they manage. ## Related Resources Learn about job management and filtering options Understand pagination best practices Retrieve a specific job by ID ## OpenAPI ````yaml GET /jobs openapi: 3.0.0 info: title: InstaView API description: |- InstaView API Documentation ## Authentication All endpoints require API key authentication using Bearer token: ``` Authorization: Bearer sk_your_api_key_here ``` ## API Key Management The API Key module provides comprehensive key management for: - **Direct Client Keys**: Company-scoped keys for your applications - **ATS Partner Keys**: Resource-scoped keys for ATS integrations ### Key Features - HMAC-SHA256 hashing for API key storage - Configurable rate limiting - Comprehensive audit logging - Company-level isolation - Resource scoping for ATS partners version: 1.0.0 contact: {} servers: - url: https://api.instaview.sk description: Production API Gateway security: [] tags: [] paths: /jobs: get: tags: - Jobs summary: List jobs description: Lists jobs for the API key's company with pagination. operationId: PublicJobsController_listJobs_v1 parameters: - name: page required: false in: query description: Page number (1-based) schema: minimum: 1 maximum: 10000 default: 1 example: 1 type: integer - name: limit required: false in: query description: Number of items per page schema: minimum: 1 maximum: 100 default: 20 example: 20 type: integer - name: companyId required: false in: query description: Company ID (required for ATS keys, optional for regular keys) schema: example: 123e4567-e89b-12d3-a456-426614174000 type: string format: uuid - name: status required: false in: query description: Filter by job status schema: example: OPEN type: string enum: - UNDEFINED - OPEN - CLOSED - name: search required: false in: query description: Search by job title schema: example: TypeScript Developer type: string responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/PublicListJobsResponseDto' security: - bearer: [] components: schemas: PublicListJobsResponseDto: type: object properties: data: description: Array of jobs type: array items: $ref: '#/components/schemas/PublicJobDto' total: type: number description: Total number of items example: 150 page: type: number description: Current page number example: 1 limit: type: number description: Number of items per page example: 20 totalPages: type: number description: Total number of pages example: 8 required: - data - total - page - limit - totalPages PublicJobDto: type: object properties: id: type: string description: Job ID example: 123e4567-e89b-12d3-a456-426614174000 companyId: type: string description: Company ID example: 987e6543-e21b-12d3-a456-426614174000 title: type: string description: Job title example: Senior TypeScript Developer description: type: string description: Job description example: We are looking for an experienced TypeScript developer... nullable: true status: type: string description: Job status enum: - UNDEFINED - OPEN - CLOSED example: OPEN jobUrl: type: string description: Job URL example: https://company.com/careers/senior-typescript-dev benefits: type: string description: Benefits example: Health insurance, remote work, flexible hours requiredSkills: description: Required skills example: - TypeScript - React - Node.js type: array items: type: string niceToHaveSkills: description: Nice-to-have skills example: - Docker - AWS type: array items: type: string languageRequirements: description: Language requirements with proficiency levels example: - language: EN proficiency: B2 - language: SK proficiency: C1 type: array items: $ref: '#/components/schemas/PublicLanguageRequirementDto' education: description: Education requirements example: - BACHELORS type: array items: type: string experience: type: string description: Experience level example: SENIOR contractType: type: string description: Contract type example: FULL_TIME location: description: Location information allOf: - $ref: '#/components/schemas/PublicJobLocationDto' salary: description: Salary range example: min: 50000 max: 80000 currency: USD period: YEARLY allOf: - $ref: '#/components/schemas/PublicSalaryRangeDto' metadata: type: object description: Custom metadata example: externalJobId: JOB-12345 department: Engineering createdAt: type: string description: Created timestamp example: '2024-11-16T10:30:00Z' updatedAt: type: string description: Updated timestamp example: '2024-11-16T10:30:00Z' required: - id - companyId - title - status - createdAt - updatedAt PublicLanguageRequirementDto: type: object properties: language: type: string description: Language enum: - UNDEFINED - EN - JA - ZH - DE - HI - FR - KO - PT - IT - ES - ID - NL - TR - FIL - PL - SV - BG - RO - AR - CS - EL - FI - HR - MS - SK - DA - TA - UK - RU - HU - 'NO' - VI example: EN proficiency: type: string description: Proficiency level (CEFR) enum: - UNDEFINED - A1 - A2 - B1 - B2 - C1 - C2 example: B2 required: - language - proficiency PublicJobLocationDto: type: object properties: workMode: type: string description: Work mode enum: - UNDEFINED - ONSITE - REMOTE - HYBRID example: REMOTE street: type: string description: Street address example: Hlavná 123 minLength: 2 maxLength: 200 city: type: string description: City example: Bratislava minLength: 2 maxLength: 100 postalCode: type: string description: Postal code example: '81101' minLength: 2 maxLength: 20 countryCode: type: string description: Country code (ISO 3166-1 alpha-2) enum: - XX - AF - AL - DZ - AS - AD - AO - AI - AQ - AG - AR - AM - AW - AU - AT - AZ - BS - BH - BD - BB - BY - BE - BZ - BJ - BM - BT - BO - BA - BW - BR - IO - BN - BG - BF - BI - KH - CM - CA - CV - KY - CF - TD - CL - CN - CX - CC - CO - KM - CG - CD - CK - CR - CI - HR - CU - CY - CZ - DK - DJ - DM - DO - EC - EG - SV - GQ - ER - EE - SZ - ET - FK - FO - FJ - FI - FR - GF - PF - TF - GA - GM - GE - DE - GH - GI - GR - GL - GD - GP - GU - GT - GG - GN - GW - GY - HT - HM - VA - HN - HK - HU - IS - IN - ID - IR - IQ - IE - IM - IL - IT - JM - JP - JE - JO - KZ - KE - KI - KP - KR - KW - KG - LA - LV - LB - LS - LR - LY - LI - LT - LU - MO - MG - MW - MY - MV - ML - MT - MH - MQ - MR - MU - YT - MX - FM - MD - MC - MN - ME - MS - MA - MZ - MM - NA - NR - NP - NL - NC - NZ - NI - NE - NG - NU - NF - MK - MP - 'NO' - OM - PK - PW - PS - PA - PG - PY - PE - PH - PN - PL - PT - PR - QA - RE - RO - RU - RW - BL - SH - KN - LC - MF - PM - VC - WS - SM - ST - SA - SN - RS - SC - SL - SG - SX - SK - SI - SB - SO - ZA - GS - SS - ES - LK - SD - SR - SJ - SE - CH - SY - TW - TJ - TZ - TH - TL - TG - TK - TO - TT - TN - TR - TM - TC - TV - UG - UA - AE - GB - US - UM - UY - UZ - VU - VE - VN - VG - VI - WF - EH - YE - ZM - ZW example: SK PublicSalaryRangeDto: type: object properties: min: type: number description: Minimum salary (must be greater than or equal to 0) example: 50000 minimum: 0 max: type: number description: Maximum salary (must be greater than or equal to 0) example: 80000 minimum: 0 currency: type: string description: Currency (ISO 4217 alpha-3) pattern: ^[A-Z]{3}$ example: USD period: type: string description: Salary period enum: - UNDEFINED - HOURLY - DAILY - MONTHLY - YEARLY example: YEARLY securitySchemes: bearer: type: http scheme: bearer description: API key for authentication using Bearer scheme ````