# Retrieve a vacancy by id

Endpoint: GET /{vacancyId}/company/{companyId}
Version: 2.0
Security: bearer, apiKey

## Path parameters:

  - `vacancyId` (string, required)

  - `companyId` (string, required)

## Response 200 fields (application/json):

  - `id` (string, required)
    Example: "6705d9eb9f2f72a28f6c974f"

  - `shortCode` (string,null, required)
    Example: "VAC-2024-001"

  - `type` (string, required)
    Enum: "Standard"

  - `companyId` (string, required)
    Example: "6705d9eb9f2f72a28f6c974f"

  - `locale` (string, required)
    Example: "es"

  - `createdByUserId` (string, required)
    Example: "6705d9eb9f2f72a28f6c974f"

  - `locationId` (number,null, required)
    Example: 12345

  - `country` (string,null, required)
    Example: "MX"

  - `status` (object, required)

  - `status.code` (string, required)
    Enum: "SAVED", "CLOSED", "IN_PROGRESS"

  - `status.createdAt` (string, required)
    Example: "2024-01-15T10:30:00Z"

  - `areaId` (string, required)
    Example: "6705d9eb9f2f72a28f6c974f"

  - `visibility` (string, required)
    Enum: "PUBLIC", "PRIVATE"

  - `workModality` (string, required)
    Enum: "ON_SITE", "REMOTE", "HYBRID"

  - `name` (string, required)
    Example: "Desarrollador Full Stack Senior"

  - `maxCandidates` (number,null, required)
    Example: 50

  - `jobDescription` (string, required)
    Example: "Buscamos un desarrollador Full Stack con experiencia en React y Node.js"

  - `jobDescriptionHtml` (string, required)
    Example: "<p>Buscamos un desarrollador Full Stack con experiencia en <strong>React</strong> y <strong>Node.js</strong></p>"

  - `requirements` (string,null, required)
    Example: "Experiencia mínima de 3 años en desarrollo web"

  - `requirementsHtml` (string,null, required)
    Example: "<p>Experiencia mínima de 3 años en desarrollo web</p>"

  - `contextAI` (string,null, required)
    Example: "Posición para equipo de desarrollo de producto"

  - `features` (array, required)

  - `features.featureCode` (string, required)
    Enum: "INTERVIEW", "DOCUMENTS", "AUTOMATIC_ENGLISH_EXAM", "AUTOMATIC_SCHEDULING_VIRTUAL", "AUTOMATIC_SCHEDULING_PRESENTIAL", "AUTOMATIC_SCHEDULING_AUTO", "AUTOMATIC_PSYCHOMETRIC", "AUTOMATIC_FORM"

  - `features.order` (number, required)
    Example: 1

  - `features.isAutomatic` (boolean, required)
    Example: true

  - `features.color` (string, required)
    Example: "#4A90E2"

  - `features.customName` (string, required)
    Example: "Entrevista inicial"

  - `features.actions` (array, required)

  - `features.actions.templateId` (string, required)
    Example: "6705d9eb9f2f72a28f6c974f"

  - `features.selfInit` (boolean, required)

  - `features.jobAutomations` (any, required)

  - `hasFinalistsEnabled` (boolean, required)

  - `taskList` (array, required)

  - `taskList.text` (string, required)
    Example: "Validar experiencia en el puesto"

  - `taskList.source` (string, required)
    Enum: "GPT", "COMPANY", "CUSTOM"

  - `taskList.relatedField` (string,null, required)
    Example: "experience"

  - `taskList.version` (number, required)
    Example: 1

  - `taskList.versionDate` (string, required)
    Example: "2024-01-15T10:30:00Z"

  - `refCode` (string,null, required)
    Example: "REF-2024-001"

  - `updatedAt` (string, required)
    Example: "2024-01-20T15:45:00Z"

## Response 404 fields (application/json):

  - `code` (number)
    Example: 404

  - `message` (string)
    Example: "Vacancy not found"