Applications

List applications

Lists candidate and job associations. Filter by job, candidate, stage, or update timestamp.

GET

/applications

List applications

curl --request GET \
  --url 'https://api.cvviz.com/v1/applications?page=1&pageSize=10&job_id=901&candidate_id=501&status=3&updated_since=2023-11-07T05%3A31%3A56Z' \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "appliedAt": "2026-08-20T08:15:00.000Z",
      "candidateEmail": "asha@example.com",
      "candidateId": 501,
      "candidateName": "Asha Sharma",
      "id": "901:501",
      "jobId": 901,
      "jobTitle": "Senior Backend Engineer",
      "stageCode": 3,
      "stageLabel": "Interview",
      "updatedAt": "2026-08-30T15:20:00.000Z"
    }
  ],
  "meta": {
    "pagination": {
      "page": 1,
      "pageSize": 10,
      "totalItems": 1,
      "totalPages": 1
    }
  }
}

Permissions

applications.read

Pagination

Use page and pageSize; see the query parameters below for defaults and limits. See Pagination & filtering for examples.

Authorizations

Authorizationstringheaderrequired

Use Authorization: Bearer <api-credential>.

Query Parameters

pageintegerquerydefault:1

One-based page number.

Required range: 1 <= x

Example: 1

pageSizeintegerquerydefault:10

Number of records returned per page.

Required range: 1 <= x <= 100

Example: 10

job_idintegerquery

Required range: 1 <= x

Example: 901

candidate_idintegerquery

Required range: 1 <= x

Example: 501

statusintegerquery

Example: 3

updated_sincestringquery

Response

Successful response.

X-API-Daily-Limitintegerheader

Daily account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x

X-API-Daily-Remainingintegerheader

Requests remaining in the daily window after admission.

Required range: 0 <= x

X-API-Daily-Resetstringheader

Daily window reset time in UTC.

X-API-Monthly-Limitintegerheader

Monthly account request allowance, when metered. Shared across API credentials.

Required range: 0 <= x

X-API-Monthly-Remainingintegerheader

Requests remaining in the monthly window after admission.

Required range: 0 <= x

X-API-Monthly-Resetstringheader

Monthly window reset time in UTC.

X-Request-IDstringheader

Request correlation identifier. Supply this value when contacting support.

Example: 01J7Y8N9P0Q1R2S3T4U5V6W7X8

X-API-Contractstringheader

Response envelope contract version.

Example: canonical-v1

RateLimit-Limitintegerheader

Account request limit for capacity add-ons; effective credential request-unit limit for included legacy access.

Example: 600

RateLimit-Remainingintegerheader

Requests remaining for capacity add-ons, or request units for included legacy access.

Example: 598

RateLimit-Resetintegerheader

Seconds until the current minute window resets.

Example: 30

dataobject[]required

Show child attributes

metaobjectrequired

Show child attributes

Still need help? Ask the team