Candidate views

Log of each time a candidate is viewed

Endpoints
GET/candidate_views

The candidate view object

Attributes

idbigint

Unique identifier

candidate_iduuid
candidates.id

Identifier of the related candidate

created_attimestamp with time zone

Creation timestamp

anonymousboolean

Whether the candidate was viewed with personal information redacted

Related resources

Embed related resources in the response with the select parameter, for example select=*,candidates(*). See selecting data. Resources related through more than one column need the column as a hint, like table!column(*).

candidates(*)object | null
candidates.id

The candidate referenced by candidate_id.

The candidate view object
JSON
{
  "id": 0,
  "candidate_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-01-01T12:00:00+00:00",
  "anonymous": false
}
Including related resources
curl "https://api.cv-transformer.com/v1/candidate_views?limit=10&select=*,candidates(*)" \
  -H "Authorization: Bearer YOUR_API_KEY"

List candidate views

Requirescandidates:read

Filters

idFilter<bigint>

Unique identifier

candidate_idFilter<uuid>
candidates.id

Identifier of the related candidate

created_atFilter<timestamp with time zone>

Creation timestamp

anonymousFilter<boolean>

Whether the candidate was viewed with personal information redacted

Responses

200

A list of candidate views with the selected columns. The Content-Range header holds the range returned and the total count, like 0-9/42.

206

Partial Content

400

The request is malformed, for example an unknown column or an invalid filter.

401

The API key is missing or invalid.

403

The API key doesn't have the scope this request needs.

429

The API key made more requests per minute than its rate limit allows. Retry after the number of seconds in the Retry-After header.

Errors have a JSON body with a message, details and hint, and for database errors a code. See errors.
GET/candidate_views
curl "https://api.cv-transformer.com/v1/candidate_views?limit=10&select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"
Example response
JSON
[
  {
    "id": 0,
    "candidate_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-01-01T12:00:00+00:00",
    "anonymous": false
  }
]