> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collective.work/llms.txt
> Use this file to discover all available pages before exploring further.

# List jobs

> List jobs in your organization and the selected environment, including jobs created outside the API. Defaults to OPEN. Use the status parameter to select one or more statuses, or ALL. Deleted jobs are always excluded. Results include expired jobs; check isExpired to hide them.

Returns paginated job summaries, ordered by createdAt descending, then jobId descending. Pagination and total use the same status and title filters. Use [Get a job](/api-reference/endpoint/job/get) to retrieve the full description and application settings. See [Job posting](/docs/jobs#list-your-jobs) for examples.



## OpenAPI

````yaml GET /jobs
openapi: 3.0.1
info:
  title: Collective Work Job API
  description: API for managing job postings on the Collective Work platform
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.collective.work/{environment}/v1
    description: Collective Work API server
    variables:
      environment:
        default: sandbox
        description: API environment
        enum:
          - sandbox
          - production
security:
  - bearerAuth: []
paths:
  /jobs:
    get:
      description: >-
        List jobs in your organization and the selected environment, including
        jobs created outside the API. Defaults to OPEN. Use the status parameter
        to select one or more statuses, or ALL. Deleted jobs are always
        excluded. Results include expired jobs; check isExpired to hide them.


        Returns paginated job summaries, ordered by createdAt descending, then
        jobId descending. Pagination and total use the same status and title
        filters. Use [Get a job](/api-reference/endpoint/job/get) to retrieve
        the full description and application settings. See [Job
        posting](/docs/jobs#list-your-jobs) for examples.
      parameters:
        - name: status
          required: false
          in: query
          style: form
          explode: false
          description: >-
            Statuses to include: OPEN, PAUSED, or CLOSED. Pass a single value
            (status=PAUSED), comma-separated values (status=OPEN,PAUSED), or
            repeated parameters (status=OPEN&status=PAUSED). Use status=ALL by
            itself to include all three statuses. Omit to select OPEN. Values
            are case-sensitive; empty or invalid values return 400.
          schema:
            type: array
            items:
              type: string
              enum:
                - OPEN
                - PAUSED
                - CLOSED
                - ALL
            minItems: 1
            maxItems: 3
            default:
              - OPEN
        - name: page
          required: false
          in: query
          description: Page number, starting at 1
          schema:
            minimum: 1
            maximum: 10000
            default: 1
            example: 1
            type: integer
        - name: pageSize
          required: false
          in: query
          description: Number of jobs per page
          schema:
            minimum: 1
            maximum: 100
            default: 50
            example: 50
            type: integer
        - name: search
          required: false
          in: query
          description: >-
            Case-insensitive substring search on the job title, within the
            selected statuses.
          schema:
            maxLength: 200
            example: developer
            type: string
      responses:
        '200':
          description: Jobs retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetJobsResponseDto'
        '400':
          description: Invalid input data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error400'
        '401':
          description: >-
            Missing or invalid API key, or organization without production API
            access. Use Authorization: Bearer <organization API key>.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
components:
  schemas:
    GetJobsResponseDto:
      type: object
      properties:
        jobs:
          description: >-
            Jobs on this page matching the selected statuses and search,
            including expired jobs, ordered by createdAt descending, then jobId
            descending. Empty when no jobs match or the page is beyond the
            results.
          type: array
          items:
            $ref: '#/components/schemas/JobSummary'
        total:
          type: integer
          description: >-
            Number of jobs matching the selected statuses and search across all
            pages, including expired jobs.
          example: 1
          minimum: 0
        page:
          type: integer
          description: Page number returned
          example: 1
          minimum: 1
          maximum: 10000
        pageSize:
          type: integer
          description: Number of jobs per page
          example: 50
          minimum: 1
          maximum: 100
      required:
        - jobs
        - total
        - page
        - pageSize
    Error400:
      type: object
      required:
        - message
        - error
        - statusCode
      properties:
        message:
          type: array
          items:
            type: string
        statusCode:
          type: integer
          example: 400
        error:
          type: string
          example: Bad Request
    Error401:
      type: object
      required:
        - message
        - error
        - statusCode
      properties:
        message:
          type: string
          example: 'Invalid authorization header: Please provide a valid API key'
        statusCode:
          type: integer
          example: 401
        error:
          type: string
          example: Unauthorized
    Error500:
      type: object
      required:
        - message
        - error
        - statusCode
      properties:
        message:
          type: array
          items:
            type: string
          example:
            - Internal server error
        statusCode:
          type: integer
          example: 500
        error:
          type: string
          example: Internal Server Error
    JobSummary:
      type: object
      properties:
        jobId:
          type: string
          description: Unique identifier of the job posting generated by Collective.
          example: cm71yqftr00000ck0bpz3hpg1
        internalJobId:
          type: string
          description: Your job identifier, provided at creation, or null when not set.
          example: CLIENT-123
          nullable: true
        jobUrl:
          type: string
          description: >-
            Public URL of the job on Collective, in the form
            `https://www.collective.work/jobs/<language>/<slug>`.
          example: https://www.collective.work/jobs/en/full-stack-developer-paris-8rnv
          format: uri
        accountEmail:
          type: string
          description: Email of the recruiter who owns the job posting
          example: recruiter@example.com
          format: email
        status:
          type: string
          description: >-
            OPEN, PAUSED, or CLOSED. The list endpoint defaults to OPEN; use its
            status parameter to select other statuses. Expiration does not
            change the status; check isExpired.
          enum:
            - OPEN
            - CLOSED
            - PAUSED
          example: OPEN
        isExpired:
          type: boolean
          description: >-
            Whether the expiration date is set and has passed. Expiry does not
            change the status.
          example: false
        expirationDate:
          type: string
          description: Expiration date of the job posting
          example: '2026-11-30T22:00:00.000Z'
          format: date-time
          nullable: true
        closedAt:
          type: string
          description: Date the job was closed, or null if it has not been closed.
          example: null
          format: date-time
          nullable: true
        createdAt:
          format: date-time
          type: string
          description: Date the job was created
          example: '2026-10-22T09:30:00.000Z'
        title:
          type: string
          description: Job title
          example: Full Stack Developer
        companyName:
          type: string
          description: Name of the company
          example: Collective
          nullable: true
        companyLogoUrl:
          type: string
          description: URL of the company logo
          example: https://assets.collective.work/logos/collective.png
          nullable: true
        budget:
          type: string
          description: Daily rate or salary range for the position, or null when not set.
          example: 600-750€/day
          nullable: true
        isSalaryAccordingToProfile:
          type: boolean
          description: Whether the salary is determined based on the candidate profile
          example: false
        contractType:
          type: string
          description: The contract type for the job
          enum:
            - FREELANCE
            - PERMANENT_CONTRACT
          example: FREELANCE
        location:
          type: string
          description: Job location, as its full English name
          example: Paris, France
          nullable: true
        workPreferences:
          type: array
          description: >-
            Work arrangements accepted for the job. Responses return an array;
            creation and update accept a single string.
          example:
            - REMOTE
            - HYBRID
          items:
            type: string
            enum:
              - REMOTE
              - HYBRID
              - ON_SITE
        skills:
          description: Required skills for the position
          example:
            - TypeScript
            - React
          type: array
          items:
            type: string
        language:
          type: string
          description: >-
            Language of the job posting, such as en, fr, or es, or null when not
            set.
          example: en
          nullable: true
      required:
        - jobId
        - internalJobId
        - jobUrl
        - accountEmail
        - status
        - isExpired
        - expirationDate
        - closedAt
        - createdAt
        - title
        - companyName
        - companyLogoUrl
        - budget
        - isSalaryAccordingToProfile
        - contractType
        - location
        - workPreferences
        - skills
        - language
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Your organization API key, available in [Organisation
        settings](https://app.collective.work/recruiter/organization/api).

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.