---
title: "Retrieve an application"
method: GET
path: "/api/v0/applications/{id}"
tags: ["Applications"]
---

# Retrieve an application

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

## Request

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

## Path parameters

- `id` integer, required

## Query parameters

- `expand` string[]
- `process_id` integer

## Headers

- `Authorization` string

## Response `200`

Returns the details of a specific application by its ID. Use this as the canonical follow-up read when you start from an application ID in a webhook payload or another collapsed relationship. Pass `expand[]=professional` when you need the related professional in the same response without making a separate professionals request.

- object
  - `data` object, required
    - `id` string, required
    - `type` string, required
    - `attributes` object, required
      - `slug` string, required
      - `deleted` boolean, required
      - `read` boolean, required
      - `messages_count` integer, required
      - `notes_count` integer, required
      - `unlocked` boolean, required
      - `source_channel` 'boost' | 'talent_db' | 'invite' | 'getonbrd' | 'linkedin' | 'facebook' | 'twitter' | 'email' | 'chat' | 'slack' | 'notion' | 'github' | 'gitlab' | 'angel_list' | 'medium' | 'awesomefest' | 'blog' | 'youtube' | 'academy' | 'search' | 'instagram' | 'meetup' | 'google_jobs' | 'aggregator' | 'other' | 'null', nullable: Server-calculated application source. Null means no source was captured; omitted for locked applications. Also included in job.application.sent and job.application.withdrawn webhooks.
      - `unread_messages_from_webpro` integer, required
      - `unread_messages_from_company` integer, required
      - `discard_reason` unknown, required
      - `expected_salary` integer, nullable, required
      - `reason_to_apply` string, required
      - `professional_background` string, required
      - `academic_background` string, required
      - `sent_at` integer, required
      - `created_at` integer, required
      - `updated_at` integer, required
      - `job` object, required
        - `data` object, required
          - `id` integer, required
          - `type` string, required
      - `phase` object, nullable, required
        - `data` object, required
          - `id` integer, required
          - `type` string, required
      - `professional` object, required
        - `data` object, required
          - `id` integer, required
          - `type` string, required
          - `attributes` object
            - `slug` string, required
            - `email` string, required
            - `name` string, required
            - `location` unknown, required
            - `description` string, nullable, required
            - `image` object, nullable, required
              - …
            - `github` string, nullable, required
            - `twitter` unknown, required
            - `linkedin` unknown, required
            - `portfolio` unknown, required
            - `min_salary` unknown, required
            - `professional_background` string, nullable, required
            - `academic_background` string, nullable, required
            - `uploaded_cv` object, required
              - …
            - `country` string, nullable, required
            - `stackoverflow` unknown, required
            - `youtube` unknown, required
            - `gitlab` unknown, required
            - `phone` unknown, required
            - `created_at` integer, required
            - `updated_at` integer, required
      - `answers` object, required
        - `data` object[], required
          - `id` integer, required
          - `type` string, required
      - `messages` object, required
        - `data` object[], required
          - `id` string, required
          - `type` string, required
          - `attributes` object, required
            - `id` integer, required
            - `text` string, required
            - `slug` string, required
            - `read` boolean, required
            - `subject` unknown, required
            - `is_email` boolean, required
            - `state` string, required
            - `source` string, required
            - `pending_release` boolean, required
            - `editable` boolean, required
            - `author` string, required
            - `created_at` integer, required
            - `updated_at` integer, required
            - `release_at` integer, required
            - `editable_until_at` integer, required
      - `notes` object, required
        - `data` unknown[], required
          - unknown

## Other responses

- `401`: Returns the details of a specific application by its ID. Use this as the canonical follow-up read when you start from an application ID in a webhook payload or another collapsed relationship. Pass `expand[]=professional` when you need the related professional in the same response without making a separate professionals request.
- `404`: Returns the details of a specific application by its ID. Use this as the canonical follow-up read when you start from an application ID in a webhook payload or another collapsed relationship. Pass `expand[]=professional` when you need the related professional in the same response without making a separate professionals request.

---

[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)