Creators

List job applications

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.

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

Query parameters

source'applied' | 'invited'

Applications the creator sent (applied) or invitations the org sent (invited)

searchstring

Search by applicant name

Example:Mara
statusesstring[]

Filter applications by one or more statuses

[
  "open",
  "in_review"
]
jobIdsstring[]

Restrict to applications on specific job postings

[
  "orgjob_RwmraAffhMt9"
]
chatIdsstring[]

Restrict to applications whose applicant's conversation is one of these chat ids

countryCodesstring[]

Applicants whose contact country is any of these ISO 3166-1 alpha-3 codes

[
  "DEU",
  "USA"
]
languagesstring[]

Applicants who speak any of these language codes

[
  "en",
  "de"
]
bookmarkedOnlyboolean

Only applications the organization bookmarked (bookmarks are shared)

unreadOnlyboolean

Only applications the calling member has not opened yet

portfolioOnlyboolean

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.

messageOnlyboolean

Only applications the creator sent with a written message

pagenumber

Page number (1-based index)

Example:1
perPagenumber

Number of items per page (1-100)

Example:10
sortColstring

Sort column

Example:publishedAt
sortDir'asc' | 'desc'

Sort direction

Example:asc

Response

OK

pageCountnumber required

Total number of pages

totalRowsnumber required

Total number of rows

Example response

{
  "data": [
    {
      "applicant": {
        "languages": [
          "en"
        ]
      }
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.