Search Verifications

Searches verification results using filters such as resumeId, type, status, or date range. Supports pagination.

Request Details

path Parameters

Field	Type	Required	Description
resumeId	string	Yes	The resume ID to filter by
type	string	No	work \| education \| social
status	string	No	pending \| complete \| failed
from	string	No	ISO date to filter createdAt
to	string	No	ISO date to filter createdAt
limit	number	No	max items to return (default 20)
cursor	string	No	pagination cursor

Sample Request & Response

GET

/v1/verifications

Sample Request

Headers:

{
  "Authorization": "Bearer <YOUR_API_KEY>"
}

Path Parameters:

{
  "resumeId": "string (required) - The resume ID to filter by",
  "type": "string (optional) - work | education | social",
  "status": "string (optional) - pending | complete | failed",
  "from": "string (optional) - ISO date to filter createdAt",
  "to": "string (optional) - ISO date to filter createdAt",
  "limit": "number (optional) - max items to return (default 20)",
  "cursor": "string (optional) - pagination cursor"
}

Sample Response (200)

{
  "verifications": [
    {
      "id": "verify_xyz123",
      "resumeId": "resume_abc123",
      "type": "work",
      "entryId": "work_1",
      "verified": true,
      "status": "complete",
      "method": "manual",
      "verifiedFields": [
        "company",
        "position",
        "dates"
      ],
      "notes": "Verified via LinkedIn",
      "createdAt": 1691379200000,
      "updatedAt": 1691381200000,
      "completedAt": 1691381300000
    },
    {
      "id": "verify_xyz124",
      "resumeId": "resume_abc123",
      "type": "education",
      "entryId": "edu_1",
      "verified": false,
      "status": "failed",
      "method": "manual",
      "notes": "Institution not found",
      "createdAt": 1691379300000,
      "updatedAt": 1691380300000
    },
    {
      "id": "verify_xyz125",
      "resumeId": "resume_abc123",
      "type": "social",
      "entryId": "social_1",
      "verified": true,
      "status": "complete",
      "method": "automatic",
      "createdAt": 1691379400000,
      "updatedAt": 1691380400000,
      "completedAt": 1691380500000
    }
  ],
  "nextCursor": null
}