Learn about the /reports endpoint.

Report objects contains information related to reports generated for a user, including:

  • Verification of Income and Employment (VOIE) reports
  • Verification of Employment (VOE) reports

Reports are generated on request and are based on data available from payroll providers.

structure of the reports object


idstringUnique ID of the report object.
userstring uuidA unique ID assigned to a user.
reference_idstring uuidUnique ID of the report referenced on the PDF used as a single reference point.
generated_atstringShows the date and time when the report was generated.
typestringType of report, either:

voie - Verification of Income and Employment (VOIE) report.

voe - Verification of Employment (VOE) report.
statusstringThe status of the report generation process. Possible values:

waiting_for_sync - account is being synced.

generating - report is being generated.

generated - report is ready to be downloaded.
file_urlstringThe file_url contains a direct link to the file. This link is valid for 15 minutes. When it expires, you can call the reports endpoint again to generate another valid URL.
metadata.purposeJSON objectReport metadata for internal use, such as the purpose of the report.


These are the endpoints available for reports.

Generate a report - POST /reports
Retrieve a report - GET /reports/:id
List reports - GET /reports

Example object

    "id": "9f82994c-774d-11eb-b1c7-13e87316bacb",
    "reference_id": "VOIE12357",
    "generated_at": "2020-11-29T08:33:41.525392Z",
    "type": "voie",
    "user": "8a5f613a-673a-4434-aeee-1a38b960b936",
    "status": "generated",
    "file_url": "",
    "metadata": {
        "purpose": "Risk Assesment"

Sample reports

Sample Verification of Income and Employment (VOIE) report

Sample Verification of Employment (VOE) report