---
title: "List applications"
method: GET
path: "/api/v0/applications"
tags: ["Applications"]
---

# List applications

`GET /api/v0/applications`

## Request

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

Filter by `process_id` when preparing a phase move. Use each returned application `id` with `PATCH /api/v0/applications/{application_id}/phase`.

## Query parameters

- `expand` string[]
- `from` integer
- `page` integer
- `per_page` integer
- `process_id` integer
- `to` integer

## Headers

- `Authorization` string, required

## Response `200`

Returns a paginated list of applications for the authenticated company.

- 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
      - `expected_salary` integer
      - `reason_to_apply` string
      - `professional_background` string
      - `academic_background` string
      - `sent_at` integer, required
      - `created_at` integer, required
      - `updated_at` integer, required
      - `job` object, required
        - `data` object, required
          - `id` integer, 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
      - `phase` object, required
        - `data` object, required
          - `id` integer, 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
      - `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, required
            - `image` object, required
              - …
            - `github` string, required
            - `twitter` unknown, required
            - `linkedin` unknown, required
            - `portfolio` unknown, required
            - `min_salary` unknown, required
            - `professional_background` string, required
            - `academic_background` string, required
            - `uploaded_cv` object, required
              - …
            - `country` string, required
            - `stackoverflow` unknown, required
            - `youtube` unknown, required
            - `gitlab` unknown, required
            - `phone` unknown, required
            - `created_at` integer, required
            - `updated_at` integer, required
      - `answers` object
        - `data` object[], required
          - `id` integer, required
          - `type` string, required
          - `attributes` object
            - `slug` string, required
            - `text` string, required
            - `language` unknown, required
            - `selected_choice` unknown[], required
              - …
            - `score` integer, required
            - `created_at` integer, required
            - `updated_at` integer, required
      - `messages` object
        - `data` object[], required
          - `id` integer, required
          - `type` string, required
          - `attributes` object
            - `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
        - `data` object[], required
          - `id` integer, required
          - `type` string, required
          - `attributes` object
            - `id` integer, required
            - `text` string, required
            - `author` string, required
            - `created_at` integer, required
            - `updated_at` integer, required
  - `meta` object, required
    - `page` integer, required
    - `per_page` integer, required
    - `total_pages` integer, required

## Other responses

- `401`: Returns a paginated list of applications for the authenticated company.
- `422`: Returns a paginated list of applications for the authenticated company.

---

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