> ## 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.

# Get Job

> Retrieve the full content of an open, paused, or closed job in your organization and the selected environment. Deleted jobs return 404.



## OpenAPI

````yaml GET /job
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:
  /job:
    get:
      description: >-
        Retrieve the full content of an open, paused, or closed job in your
        organization and the selected environment. Deleted jobs return 404.
      parameters:
        - in: query
          name: id
          schema:
            type: string
          required: true
          description: >-
            Unique identifier of the job (automatically generated by Collective)
            or Internal identifier of the job posting (provided by you when you
            created the job)
      responses:
        '200':
          description: Job successfully retrieved
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JobResponse'
        '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'
        '404':
          description: Job not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error500'
components:
  schemas:
    JobResponse:
      allOf:
        - $ref: '#/components/schemas/JobSummary'
        - type: object
          required:
            - description
            - profileWanted
            - questions
            - requirePhoneNumber
            - notifyByEmailForEveryApplication
          properties:
            description:
              type: string
              description: Job description (text or sanitized HTML)
              example: <p>We are looking for a full stack developer.</p>
              nullable: true
            profileWanted:
              type: string
              description: >-
                Description of the ideal candidate profile (text or sanitized
                HTML)
              example: <p>5 years of experience with TypeScript.</p>
              nullable: true
            questions:
              description: Questions for applicants, in display order
              example:
                - Why are you interested in this job?
              type: array
              items:
                type: string
            requirePhoneNumber:
              type: boolean
              description: Whether phone number is required for application
              example: false
            notifyByEmailForEveryApplication:
              type: boolean
              description: >-
                Whether the recruiter who posted the job is notified by email
                for every application
              example: false
    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
    Error404:
      type: object
      required:
        - message
        - error
        - statusCode
      properties:
        message:
          type: array
          items:
            type: string
          example:
            - Resource not found
        statusCode:
          type: integer
          example: 404
        error:
          type: string
          example: Not Found
    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.