---
title: "Get a requisition"
method: GET
path: "/requisitions/{requisitionId}"
tags: ["Requisition API:Requisitions"]
---

# Get a requisition

`GET /requisitions/{requisitionId}`

## Path parameters

- `requisitionId` integer, required

## Query parameters

- `Embed` string[]

## Response `200`

Requested requisition details

- RequisitionRepresentation
  - `requisitionId` integer, required
  - `status` 'Draft' | 'Submitted' | 'Rejected' | 'Approved' | 'Closed', string
  - `workflowStageIndex` integer, nullable
  - `jobTitle` string, required
  - `jobOrderId` integer, nullable
  - `company` CompanyNameModel
    - `companyId` integer, required — Unique identifier for the company
    - `name` string, nullable — Company name
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `hiringManager` ContactNameModel
    - `contactId` integer, required — Unique identifier for the contact
    - `firstName` string, nullable — First name
    - `lastName` string, nullable — Last name
    - `position` string, nullable — Position or job title
    - `salutation` string, nullable — Salutation/honorific/title
    - `unsubscribed` boolean
    - `email` string, nullable — Primary email address
    - `phone` string, nullable — Phone number
    - `mobile` string, nullable — Mobile/cell number
    - `mobileNormalized` string, nullable — Mobile/cell normalized number
    - `inactive` boolean — Contact is no longer with the company
    - `status` StatusModel
      - `statusId` integer, required
      - `name` string, required
      - `active` boolean
      - `default` boolean
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `workflow` CompanyWorkflowModel
    - `workflowId` integer, required
    - `name` string, required
    - `archived` boolean
    - `approvers` CompanyWorkflowApproverModel[], nullable
      - `stageIndex` integer, required
      - `contactId` integer, required — Unique identifier for the contact
      - `firstName` string, nullable — First name
      - `lastName` string, nullable — Last name
      - `position` string, nullable — Position or job title
      - `salutation` string, nullable — Salutation/honorific/title
      - `unsubscribed` boolean
      - `email` string, nullable — Primary email address
      - `phone` string, nullable — Phone number
      - `mobile` string, nullable — Mobile/cell number
      - `mobileNormalized` string, nullable — Mobile/cell normalized number
      - `inactive` boolean — Contact is no longer with the company
      - `status` StatusModel
        - `statusId` integer, required
        - `name` string, required
        - `active` boolean
        - `default` boolean
      - `owner` UserNameModel
        - `userId` integer, required
        - `firstName` string, nullable
        - `lastName` string, nullable
        - `position` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `mobile` string, nullable
        - `inactive` boolean
        - `deleted` boolean
  - `jobDescription` string, nullable
  - `numberOfJobs` integer
  - `source` string, nullable — Source of the requisition, or reason the requisition is being raised.
  - `workplaceAddress` CompanyAddressModel
    - `addressId` string, uuid, required
    - `name` string, nullable
    - `street` string[], nullable
    - `city` string, nullable
    - `state` string, nullable
    - `postalCode` string, nullable
    - `country` string, nullable
    - `countryCode` string, nullable
    - `phone` string, nullable
    - `fax` string, nullable
    - `url` string, uri, nullable
  - `category` JobOrderCategoryModel
    - `categoryId` integer, required
    - `name` string, required
    - `subCategory` JobOrderSubCategoryModel
      - `subCategoryId` integer, required
      - `name` string, required
  - `location` JobOrderLocationModel
    - `locationId` integer, required
    - `name` string, required
    - `area` JobOrderLocationAreaModel
      - `areaId` integer, required
      - `name` string, required
  - `start` JobOrderStartModel
    - `immediate` boolean
    - `relative` RelativeStartModel
      - `period` integer
      - `unit` 'Week' | 'Month', string
    - `date` string, date, nullable — The specific date that a job starts or a candidate is available
  - `duration` DurationModel
    - `period` integer
    - `unit` 'Hour' | 'Day' | 'Week' | 'Month', string
  - `workType` WorkTypeModel
    - `workTypeId` integer, required
    - `name` string, required
    - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string
  - `salary` JobOrderSalaryRangeModel
    - `ratePer` 'Hour' | 'Day' | 'Week' | 'Month' | 'Year', string
    - `rateLow` number, double, nullable
    - `rateHigh` number, double, nullable
    - `currency` string, nullable — Optional ISO 4217 3-letter alphabetic currency code
    - `timePerWeek` number, double, nullable — Number of days per week for a daily rate or hours per week for an hourly rate.
  - `custom` CustomFieldValueModel[], nullable
    - `fieldId` integer, required
    - `name` string, required
    - `type` 'Text' | 'List' | 'Date' | 'Lookup' | 'Url', string, required — The type of value a custom field expects
    - `value` unknown
  - `owner` UserNameModel
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `recruiters` UserNameModel[], nullable
    - `userId` integer, required
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `position` string, nullable
    - `email` string, nullable
    - `phone` string, nullable
    - `mobile` string, nullable
    - `inactive` boolean
    - `deleted` boolean
  - `formID` integer, nullable
  - `links` RequisitionLinks
    - `self` string, uri, nullable
    - `workflow` string, uri, nullable
    - `job` string, uri, nullable — Link to job created for an approved requisition
    - `history` string, uri, nullable — Link to requisition approval history
    - `notes` string, uri, nullable — Notes

## Other responses

- `404` — Requested requisition was not found

---

[API](https://skmtc.net/jobadder/apis/jobadder-api.md) · [All operations](https://skmtc.net/jobadder/apis/jobadder-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jobadder/jobadder-api/versions/9f43f6a6ee6e/schema)