---
title: "List job applications"
method: GET
path: "/applications"
tags: ["Creators"]
---

# List job applications

`GET /applications`

## Request

- Base URL: `https://viral.app/api/v1`
- URL: `https://viral.app/api/v1/applications`
- Auth: API key in header `x-api-key`

Retrieves creator applications to the current organization's job postings, including the applicant, the job, the organization's shared bookmark flag, and unread chat messages. Applicant email addresses are only returned for accepted applications.

## Query parameters

- `source` 'applied' | 'invited': Applications the creator sent (`applied`) or invitations the org sent (`invited`)
- `search` string: Search by applicant name
- `statuses` string[]: Filter applications by one or more statuses
- `jobIds` string[]: Restrict to applications on specific job postings
- `chatIds` string[]: Restrict to applications whose applicant's conversation is one of these chat ids
- `countryCodes` string[]: Applicants whose contact country is any of these ISO 3166-1 alpha-3 codes
- `languages` string[]: Applicants who speak any of these language codes
- `bookmarkedOnly` boolean: Only applications the organization bookmarked (bookmarks are shared)
- `unreadOnly` boolean: Only applications the calling member has not opened yet
- `portfolioOnly` boolean: Only applicants whose profile shows a portfolio: at least one featured account AND at least one featured video. Videos submitted for a job's application challenge do not count.
- `messageOnly` boolean: Only applications the creator sent with a written message
- `page` number: Page number (1-based index)
- `perPage` number: Number of items per page (1-100)
- `sortCol` string: Sort column
- `sortDir` 'asc' | 'desc': Sort direction

## Response `200`

OK

- object: Paginated list of job applications
  - `data` object[], required
    - `id` string, required
    - `jobId` string, required
    - `statusChangedAt` string, date-time, required
    - `answeredAt` string, date-time, nullable, required
    - `comment` string, nullable, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `status` 'open' | 'in_review' | 'accepted' | 'rejected' | 'withdrawn' | 'auto_closed' | 'invited' | 'not_interested' | 'answered' | 'retracted', required
    - `source` 'applied' | 'invited', required
    - `applicant` object, required
      - `id` string, required
      - `name` string, nullable, required
      - `email` string, nullable, required
      - `image` string, nullable, required
      - `orgCreatorId` string, nullable, required
      - `countryCode` string, nullable, required
      - `age` integer, nullable, required
      - `gender` 'female' | 'male' | 'non_binary' | 'prefer_not_to_say', nullable, required
      - `languages` string[], required
      - `ugcExperience` 'none' | 'posts_own_content' | 'created_for_brands', nullable, required
      - `weeklyVideoCapacity` '3_5' | '6_10' | '11_20' | '20_plus', nullable, required
      - `weeklyHoursAvailable` '0_5' | '5_10' | '10_15' | '15_20' | '20_25' | '25_30' | '30_35' | '35_40', nullable, required
      - `aiContentUsage` 'none' | 'partial' | 'only', nullable, required
      - `niches` string[], required
      - `contentFormats` string[], required
      - `platforms` string[], required
      - `verifiedPlatforms` string[], required
      - `hasPortfolioVideos` boolean, required
      - `profileCompleteness` number, required
    - `job` object, required
      - `id` string, required
      - `productTitle` string, required
      - `logoUrl` string, nullable, required
      - `status` 'draft' | 'public' | 'paused', required
      - `jobType` string, required
      - `productNiches` string[], required
      - `contentFormats` string[], required
      - `platformFocus` string[], required
      - `languages` string[], required
      - `countryResidences` string[], required
      - `minAge` integer, nullable, required
      - `aiContentPolicy` string, nullable, required
      - `minWeeklyHours` integer, nullable, required
      - `minWeeklyVideos` integer, nullable, required
    - `statusChangedByUser` object, nullable, required
      - `id` string, required
      - `name` string, required
      - `image` string, nullable, required
    - `bookmarked` boolean, required
    - `viewerHasRead` boolean, required
    - `hasApplicationMessage` boolean, nullable, required
    - `chatId` string, nullable, required
    - `unreadCount` integer, required
  - `pageCount` number, required: Total number of pages
  - `totalRows` number, required: Total number of rows

## Other responses

- `400`: 400
- `401`: 401
- `402`: 402
- `404`: 404
- `408`: 408
- `429`: 429
- `500`: 500

---

[API](https://skmtc.dev/viral/apis/viral-app-api.md) · [All operations](https://skmtc.dev/viral/apis/viral-app-api/llms.txt) · [OpenAPI document](https://skmtc.dev/viral/apis/viral-app-api/revisions/31e97fa79ef1?raw)