---
title: "Get a job application"
method: GET
path: "/applications/{id}"
tags: ["Creators"]
---

# Get a job application

`GET /applications/{id}`

## Request

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

Retrieves one application with the applicant's discovery profile, portfolio, challenge submissions, and social accounts. Contact details are only included once the application is accepted.

## Path parameters

- `id` string, required: Job application ID

## Query parameters

- `queueTab` union: Review-queue scope for the pager fields (previous/next/position/total). Defaults to the tab group of the application's current status, within its own source.
  - 'open' | 'inReview' | 'closed'
  - 'invited' | 'toReview' | 'closed'

## Response `200`

OK

- object
  - `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
  - `requestMessage` string, nullable, required
  - `applicant` object, required
    - `id` string, required
    - `name` 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
    - `niches` string[], required
    - `contentFormats` 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
    - `educationLevel` 'high_school' | 'in_college' | 'graduated' | 'other', nullable, required
    - `schoolName` string, nullable, required
    - `fieldOfStudy` string, nullable, required
    - `graduationYear` integer, nullable, required
    - `contact` object, nullable, required
      - `email` string, required
      - `phoneNumber` string, nullable, required
      - `address` string, nullable, required
      - `city` string, nullable, required
      - `postalCode` string, nullable, required
  - `job` object, required
    - `id` string, required
    - `productTitle` string, required
    - `logoUrl` string, nullable, required
    - `status` 'draft' | 'public' | 'paused', required
    - `jobType` string, required
    - `videoSubmissionRequired` boolean, required
    - `challengeBrief` union, required
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
  - `portfolioVideos` object[], required
    - `id` string, required
    - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
    - `platformVideoId` string, required
    - `url` string, required
    - `username` string, required
    - `validationStatus` 'pending' | 'ok' | 'not_found' | 'private' | 'failed', required
    - `stats` object, nullable, required
      - `username` string, nullable, required
      - `caption` string, nullable, required
      - `thumbnailUrl` string, nullable, required
      - `viewCount` number, nullable, required
      - `likeCount` number, nullable, required
      - `commentCount` number, nullable, required
      - `shareCount` number, nullable, required
      - `bookmarkCount` number, nullable, required
      - `engagementRate` number, nullable, required
      - `publishedAt` string, nullable, required
      - `lastSyncedAt` string, nullable, required
    - `orgTracked` boolean, required
  - `submissionVideos` object[], required
    - `id` string, required
    - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
    - `platformVideoId` string, required
    - `url` string, required
    - `username` string, required
    - `validationStatus` 'pending' | 'ok' | 'not_found' | 'private' | 'failed', required
    - `stats` object, nullable, required
      - `username` string, nullable, required
      - `caption` string, nullable, required
      - `thumbnailUrl` string, nullable, required
      - `viewCount` number, nullable, required
      - `likeCount` number, nullable, required
      - `commentCount` number, nullable, required
      - `shareCount` number, nullable, required
      - `bookmarkCount` number, nullable, required
      - `engagementRate` number, nullable, required
      - `publishedAt` string, nullable, required
      - `lastSyncedAt` string, nullable, required
    - `orgTracked` boolean, required
  - `socialAccounts` object[], required
    - `id` string, required
    - `platform` 'facebook' | 'instagram' | 'tiktok' | 'youtube' | 'snapchat', required: Social media platform (facebook, instagram, tiktok, youtube, snapchat)
    - `initialUsername` string, required
    - `kind` 'personal' | 'ugc_ambassador', nullable, required
    - `platformAccountId` string, nullable, required
    - `validationStatus` 'pending' | 'ok' | 'not_found' | 'private' | 'failed', required
    - `validatedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `stats` object, nullable, required
      - `username` string, nullable, required
      - `displayName` string, nullable, required
      - `profilePictureUrl` string, nullable, required
      - `bio` string, nullable, required
      - `followerCount` number, nullable, required
      - `followingCount` number, nullable, required
      - `videoCount` number, nullable, required
      - `lastSyncedAt` string, nullable, required
    - `orgTracked` boolean, required
  - `chatId` string, nullable, required
  - `bookmarked` boolean, required
  - `previousApplicationId` string, nullable, required: Job application ID
  - `nextApplicationId` string, nullable, required: Job application ID
  - `firstApplicationId` string, nullable, required: Job application ID
  - `lastApplicationId` string, nullable, required: Job application ID
  - `queueTab` union, required
    - 'open' | 'inReview' | 'closed'
    - 'invited' | 'toReview' | 'closed'
  - `queuePosition` integer, required
  - `queueTotal` integer, required

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