---
title: "Retrieve a process"
method: GET
path: "/api/v0/processes/{id}"
tags: ["Processes"]
---

# Retrieve a process

`GET /api/v0/processes/{id}`

## Request

- Base URL: `https://www.getonbrd.com`
- URL: `https://www.getonbrd.com/api/v0/processes/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/getonbrd/apis/get-on-board-api/docs/api/v0/processes/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Query parameters

- `expand` string[]

## Headers

- `Authorization` string

## Response `200`

Returns the details of a specific hiring process by its ID.

- object
  - `data` object, required
    - `id` string, required
    - `type` string, required
    - `attributes` object, required
      - `active` boolean, required
      - `unlocked` boolean, required
      - `featured` boolean, required
      - `expires_on` integer, required
      - `created_at` integer, required
      - `updated_at` integer, required
      - `featured_at` integer, required
      - `closed_at` integer, required
      - `job` object, required
        - `data` object, required
          - `id` string, required
          - `type` string, required
          - `attributes` object
            - `title` string, required
            - `description_headline` unknown, required
            - `description` string, required
            - `projects` string, required
            - `functions_headline` unknown, required
            - `functions` string, required
            - `benefits_headline` unknown, required
            - `benefits` string, required
            - `desirable_headline` unknown, required
            - `desirable` string, required
            - `remote` boolean, required
            - `remote_modality` string, required
            - `remote_zone` unknown, required
            - `countries` string[], required
            - `lang` string, required
            - `rejected_reasons` object[], required: Job moderation reasons, meaningful when state is rejected or submitted after rejection. Published jobs may retain earlier reasons. Each item has one reason key with localized title and description. Legacy jobs may also contain retired keys: candidate, compensation_missing, other. Consumers should tolerate unknown keys. Private job responses and job.created/job.updated webhooks share this shape.
              - …
            - `category_name` string, required
            - `perks` unknown[], required
              - …
            - `min_salary` integer, required
            - `max_salary` integer, required
            - `published_at` integer, required
            - `response_time_in_days` object, required
              - …
            - `applications_count` integer, required
            - `location_regions` object, required
              - …
            - `location_tenants` object, required
              - …
            - `location_cities` object, required
              - …
            - `modality` object, required
              - …
            - `seniority` object, required
              - …
            - `tags` object, required
              - …
            - `state` string, required
            - `company_shell_id` unknown, required
            - `deleted` boolean, required
            - `questions` object, required
              - …
            - `location_countries` object, required
              - …
            - `submitted_at` integer, required
            - `created_at` integer, required
            - `updated_at` integer, required
            - `hide_salary` boolean
            - `hiring_company` unknown
            - `hiring_company_website` unknown
      - `phases` object, required
        - `data` object[], required
          - `id` string, required
          - `type` string, required
          - `attributes` object
            - `title` string, required
            - `position` integer, required
            - `kind` string, required
            - `reserved` boolean, required
            - `created_at` integer, required
            - `updated_at` integer, required

## Other responses

- `401`: Returns the details of a specific hiring process by its ID.
- `404`: Returns the details of a specific hiring process by its ID.

---

[API](https://skmtc.dev/getonbrd/apis/get-on-board-api.md) - [All operations](https://skmtc.dev/getonbrd/apis/get-on-board-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getonbrd/apis/get-on-board-api/revisions/f8405113049f?raw)
