Sign in

v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Candidate

candidate.listClientInfo

Lists client information records (IP, user agent) collected for a candidate.

Requires the candidatesRead permission.

post/candidate.listClientInfo

Request body

candidateIdstring uuid required

The id of the candidate to fetch client info for

cursorstring nullable

Opaque cursor indicating which page of results to fetch

syncTokenstring nullable

An opaque token representing the last time the data was successfully synced from the API. A new, updated one is returned after successfully fetching the last page of data.

limitnumber nullable

The maximum number of items to return. The maximum and default value is 100.

Example request

{
  "candidateId": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
  "cursor": "G8",
  "syncToken": "jYnEBmjzR",
  "limit": 25
}

Response

Responses from the candidate.listClientInfo endpoint

OR

Example response

{
  "success": true,
  "results": [
    {
      "id": "7d31034c-790b-4265-bf63-d65396d59d0b",
      "ipAddress": "86.234.23.243",
      "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/135.0.0.0 Safari/537.36",
      "relatedEntityType": "application",
      "relatedEntityId": "57133f77-9362-4397-b395-03bda1f72303",
      "candidateId": "9d22854f-c929-4b86-9f42-cb71cc0e4fc7",
      "createdAt": "2024-01-15T10:30:00.000Z"
    }
  ],
  "moreDataAvailable": false,
  "syncToken": "sync-token-example"
}