Reports

Integration Guides API v2

Workflow reports contain the results and supporting data for a workflow. Report availability depends on the workflow and product status.

Reports are available in the following formats:

  • JSON for programmatic processing
  • ZIP archives for audit and compliance workflows
  • PDF for human-readable review
  • XML for structured exports

Report availability

The reports you can retrieve depend on the workflow and product status.

In most cases, all report formats are available after the workflow reaches completed. The following exceptions apply:

  • JSON reports are available at any stage of the workflow.
  • XML reports are also available when the workflow status is failed.
  • PDF and ZIP reports are not available when the Identity Verification product status is inconsistent_data.
Product statusWorkflow statusJSONZIPPDFXML
completedcompleted✅✅✅✅
inconsistent_datacompleted✅❌❌✅
invalid_datafailed✅❌❌✅
new / pendingnew / pending✅❌❌❌

Note

Reports are generated asynchronously and might not be available immediately after the workflow reaches the required status. If a report request returns 404 Not Found or 409 Conflict, wait before trying again. Increase the time between attempts until the report becomes available.


JSON reports

Call Get report as JSON to retrieve a workflow report in JSON format.

JSON report example

The following example shows a JSON report for a workflow that includes eID Verification.

Flow variant

The flowVariant field indicates whether the client completed eID verification or verification with a physical ID document.

This field is returned only when the workflow offers both verification methods. Otherwise, it is omitted.

flowVariantClient completed
eIDVerificationeID
DocumentVerificationVerification with a physical ID document

Important

Get workflow status and workflow webhooks return the same value. PDF and XML reports do not include flowVariant.

{
  "tenant": "QA",
  "workflowId": "3f1c9a52-8d4e-4b7a-9c1e-2a6f0d5b7e11",
  "workflow": "IdvOrEIDMinWorkflow",
  "flowVariant": "eIDVerification",
  "workflowStatus": "completed",
  "clientId": "7d0b6e3a-2c51-4f9e-a8b4-91e3c5f0d612",
  "products": [
    {
      "name": "IdentityVerification",
      "productStatus": "completed",
      "lastModified": "2026-10-20T14:32:10Z",
      "identityData": {},
      "identityDocumentData": {}
    }
  ]
}

Tax information

The Identity Verification product contains identityData.tax.

This field is populated when tax collection is enabled for the workflow and a value was provided or corrected during review.

  • App Drop-in and Web SDK: Capture tax information when the Tax Number module is enabled.
  • API-only and App Components: Send identityData.tax using Upload client data.

When tax information is not collected, the JSON report usually contains an empty tax object:

"tax": {}

When tax data is present, the object contains the following fields:

FieldMeaning
countrySubjectToTaxationISO 3166-1 alpha-3, uppercase, for example ESP
tinClient tax identification number
usPersonWhether the client is a U.S. person.
usTinU.S. tax identification number, 123-45-6789 when present

For example:

"tax": {
  "countrySubjectToTaxation": "ESP",
  "tin": "999999999",
  "usPerson": "no",
  "usTin": "123-45-6789"
}

Additional JSON examples

The following examples show JSON reports for workflows that combine Identity Verification with other products.

{
  "tenant": "{{tenant}}",
  "workflowId": "{{workflowId}}",
  "workflow": "IdvAndQesWorkflow",
  "workflowStatus": "completed",
  "clientId": "{{clientId}}",
  "products": [
    {
      "name": "IdentityVerification",
      "lastModified": "2026-04-17T13:00:04.6382611+02:00",
      "identityData": {
        "personalData": {
          "firstName": "{{firstName}}",
          "lastName": "{{lastName}}",
          "gender": "Male",
          "placeOfBirth": "{{placeOfBirth}}",
          "countryOfBirth": "ESP",
          "birthDate": "1965-03-10T00:00:00Z",
          "nationality": "NLD"
        },
        "address": {
          "streetName": "{{streetName}}",
          "streetNumber": "{{streetNumber}}",
          "city": "{{city}}",
          "country": "ESP",
          "postalCode": "{{postalCode}}"
        },
        "contactDetails": {
          "email": "{{email}}",
          "phone": "{{phoneNumber}}",
          "mobile": "{{mobileNumber}}"
        },
        "tax": {},
        "deviceMetaData": {
          "language": "ES",
          "model": "iPhone 12 Pro Max",
          "sdkVersion": "4.1.0"
        }
      },
      "identityDocumentData": {
        "documentNumber": "{{documentNumber}}",
        "documentType": "Passport",
        "issuingCountry": "NLD",
        "expirationDate": "2031-08-30",
        "issueDate": "2021-08-30"
      }
    },
    {
      "name": "Signatures",
      "productStatus": "signed",
      "lastModified": "2026-04-17T11:00:17.950744Z"
    }
  ],
  "receivedData": {
    "files": [
      {
        "type": "SelfieImage",
        "fileName": "{{selfieFileName}}"
      },
      {
        "type": "DocumentImage",
        "side": "Front",
        "documentId": "{{documentId}}"
      },
      {
        "type": "DocumentToSign",
        "fileName": "{{documentToSignFileName}}"
      }
    ]
  },
  "sla": {
    "withinSla": true
  },
  "risk": {
    "conclusion": "Low",
    "statusCode": 200,
    "description": "Low"
  }
}

ZIP reports

A ZIP archive includes one or more of the following, depending on the workflow configuration:

  • PDF report
  • XML export
  • Uploaded identity media
  • Extracted workflow data

XML export

An XML export can include:

  • Extracted identity data, including:
    • Document type
    • Issuing country
    • Expiration date
  • Corrected identity data
  • References to uploaded files

File paths in the XML reference uploaded media included in the archive, such as document images, selfies, and videos.

For a detailed description of the XML structure and attributes, see XML reports.

Example ZIP archive structure

Example ZIP archive structure

Example ZIP archive structure


PDF reports

Depending on the workflow configuration and enabled products, PDF reports can include the following sections.

PDF report contents

PDF reports can include the following sections depending on the workflow configuration and enabled products.

SectionContents
Cover pageWorkflow outcome, identifiers, timestamps, configured products, and recommended actions
DisclaimerTerms and conditions for the generated report
Checks overviewHigh-level summary of the areas that were checked
Personal dataExtracted and corrected identity data
Tax informationCountry of taxation and TIN information
Identity filesUploaded identity files and extracted document data
Risk categoryFinal workflow risk assessment
Agent detailsProcessing and review agent information
AML screeningScreening databases, hit types, and review outcomes
Identity mediaSelfies, document images, videos, and security feature assessments
Document addressAddress extracted from the ID document
Document typeDocument type extracted from the ID document, for example Passport or National ID Card
Document issuing countryIssuing country extracted from the ID document. Format: ISO 3166-1 alpha-3
Document expiration dateExpiration date extracted from the ID document. Format: YYYY-MM-DD

XML reports

To retrieve an XML file containing identity data, callGet report as ZIP or Get report as XML.

XML report structure

The following sections describe the XML elements and their attributes.

SafenedKYC
AttributeDescription
SafenedKYCThe container for the XML file.
ClientNumberProvider
Type: String
Reserved for the partner client identifier. Currently empty.
ModifiedDateTime
Type: Datetime
The timestamp for when the XML file was last modified.
Format: DD/MM/YYYY HH:mm:ss
Provider
Type: String
Your name in Fourthline's system.
Identification

Identification contains the client's personal data and identity files.

Person
AttributeDescription
Person
Type: Object
The client's personal data.
Type
Type: String
The type of entity: Natural Person.
Name
Type: String
The client's full name.
Initials
Type: String
The client's initials. Empty if not available.
FirstName
Type: String
The client's first name. Set to [NOT PROVIDED] if no value was inputted or extracted.
MiddleName
Type: String
The client's middle name. Empty if not available.
LastName
Type: String
The client's last name. Set to [NOT PROVIDED] if no value was inputted or extracted.
Nationality
Type: String
The client's nationality.
Format: ISO 3166-1 alpha-3
Gender
Type: String
The client's sex: Female, Male, Other, Unknown.
CountryOfBirth
Type: String
The country where the client was born.
Format: ISO 3166-1 alpha-3
PlaceOfBirth
Type: String
The city where the client was born. Set to [NOT PROVIDED] if no value was inputted or extracted.
BirthDate
Type: Date
The client's date of birth.
Format: YYYY-MM-DD
Address
AttributeDescription
Address
Type: Object
The client's address details.
Street
Type: String
The street of the address.
StreetNumber
Type: String
The street number of the address.
StreetNumberPrefix
Type: String
The prefix of the street number. Empty if not available.
StreetNumberSuffix
Type: String
The suffix of the street number. Empty if not available.
SecondAddressLine
Type: String
The second line of the address. Empty if not available.
PostalCode
Type: String
The postal code of the client's address.
Region
Type: String
The region of the client's address. Empty if not available.
City
Type: String
The city of the client's address.
Country
Type: String
The country of the client's address.
Format: ISO 3166-1 alpha-3
EmailAndPhone
AttributeDescription
EmailAndPhone
Type: Object
The client's email address and phone number(s).
Email
Type: String
The client's email address.
Phone
Type: String
The client's landline number. Empty if not available.
Mobile
Type: String
The client's mobile phone number. Empty if not available.
Documents
AttributeDescription
Documents
Type: Array of objects
The container for the identity files.
IdentificationDocument
Type: Object
The container for each identity file.
DocumentType
Type: String
The type of identity file:
• Document Video
• Driving License
• National ID Card
• Passport
• Proof of Residence
• Residence Permit
• Selfie
• Selfie Video
DocumentNumber
Type: String
The ID document number. Empty if not applicable.
DocumentIssuingCountry
Type: String
The country that issued the ID document.
Format: ISO 3166-1 alpha-3
Files
Type: Object
The container for the identity file photos and videos.
Files.File
Type: Object
The container for each photo or video.
Files.File.FileLocation
Type: String
The filename of the photo or video within the ZIP file.
Files.File.Side
Type: String
The side of the ID document shown: Front, Back, InsideLeft, InsideRight.
Files.File.FileType
Type: String
The type of file. Example: JPG, MP4.
IssueDate
Type: Date
The date the ID document was issued.
Format: YYYY-MM-DD
ExpirationDate
Type: Date
The date the ID document expires.
Format: YYYY-MM-DD
ResidenceAddress
Type: String
The residence address extracted from the ID document. Returns N/A if no address is available or if the check is not configured.
Tax
AttributeDescription
Tax
Type: Object
The client's tax information.
CountrySubjectToTaxation
Type: String
The country where the client is subject to taxation.
Format: ISO 3166-1 alpha-3. Empty if not provided.
TIN
Type: String
The client's tax identification number. Set to N/A if no value is available. Set to [NOT PROVIDED] if no value was inputted or extracted.
USPerson
Type: String
Whether the client is a US citizen: True, False.
USTIN
Type: String
The client's US tax identification number. Empty if not provided.
Profession
AttributeDescription
Profession
Type: Object
The client's profession and employment situation.
Employment
Type: String
The client's employment status:
• no: The client is not employed.
• self-employed: The client is self-employed.
• yes: The client is employed.
Empty if not provided.
Profession
Type: String
What the client does for work. Empty if not provided.
Industry
Type: String
The industry the client works in. Empty if not provided.
DeviceMetaData

Present only when device metadata collection is enabled in your workflow configuration.

AttributeDescription
IpAddress
Type: String
The IP address of the client's device.

XML report example

The following example shows the structure of an XML report.

Note

ClientNumberProvider is currently empty in the XML report. This field will be populated with the partner client identifier in a future release.


<?xml version="1.0" encoding="utf-8"?>
<SafenedKYC xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            Provider="Fourthline"
            ClientNumberProvider=""
            ModifiedDateTime="08/06/2026 07:20:27">
  <Identification>
    <Person>
      <Type>Natural Person</Type>
      <Name>WILLEKE LISELOTTE DE BRUIJN</Name>
      <Initials></Initials>
      <FirstName>WILLEKE LISELOTTE</FirstName>
      <MiddleName></MiddleName>
      <LastName>DE BRUIJN</LastName>
      <Nationality>NLD</Nationality>
      <Gender>Female</Gender>
      <CountryOfBirth>NLD</CountryOfBirth>
      <PlaceOfBirth>SPECIMEN</PlaceOfBirth>
      <BirthDate>1965-03-10</BirthDate>
    </Person>
    <Address>
      <Street>CARRER DE LA CIUTAT DE GRANADA</Street>
      <StreetNumber>152</StreetNumber>
      <StreetNumberPrefix></StreetNumberPrefix>
      <StreetNumberSuffix></StreetNumberSuffix>
      <SecondAddressLine></SecondAddressLine>
      <PostalCode>08018</PostalCode>
      <Region></Region>
      <City>BARCELONA</City>
      <Country>ESP</Country>
    </Address>
    <EmailAndPhone>
      <Email>[email protected]</Email>
      <Phone></Phone>
      <Mobile></Mobile>
    </EmailAndPhone>
    <Documents>
      <IdentificationDocument>
        <DocumentType>Selfie</DocumentType>
        <Files>
          <File>
            <FileLocation>f4cf7bcc-07d2-4085-b954-82e8b99fa98a.jpg</FileLocation>
            <Side>Front</Side>
            <FileType>JPG</FileType>
          </File>
        </Files>
        <ResidenceAddress>N/A</ResidenceAddress>
      </IdentificationDocument>
      <IdentificationDocument>
        <DocumentType>Selfie Video</DocumentType>
        <Files>
          <File>
            <FileLocation>7ea47830-2bd4-4e1f-adce-6ca333e30c07.mp4</FileLocation>
            <Side>Front</Side>
            <FileType>MP4</FileType>
          </File>
        </Files>
        <ResidenceAddress>N/A</ResidenceAddress>
      </IdentificationDocument>
      <IdentificationDocument>
        <DocumentType>Passport</DocumentType>
        <DocumentNumber>SPECI2021</DocumentNumber>
        <Files>
          <File>
            <FileLocation>9cfc19f9-d3a3-4179-9e3e-d7b49be92320.jpg</FileLocation>
            <Side>Front</Side>
            <FileType>JPG</FileType>
          </File>
        </Files>
        <IssueDate>2021-08-30</IssueDate>
        <ExpirationDate>2031-08-30</ExpirationDate>
        <ResidenceAddress>N/A</ResidenceAddress>
      </IdentificationDocument>
      <IdentificationDocument>
        <DocumentType>Document Video</DocumentType>
        <Files>
          <File>
            <FileLocation>27844c09-4db5-4796-85f8-c45fd4779e96.mp4</FileLocation>
            <Side>Front</Side>
            <FileType>MP4</FileType>
          </File>
        </Files>
        <ResidenceAddress>N/A</ResidenceAddress>
      </IdentificationDocument>
    </Documents>
    <Tax>
      <CountrySubjectToTaxation></CountrySubjectToTaxation>
      <TIN></TIN>
      <USPerson>False</USPerson>
      <USTIN></USTIN>
    </Tax>
  </Identification>
  <Profession>
    <Employment></Employment>
    <Profession></Profession>
    <Industry></Industry>
  </Profession>
</SafenedKYC>