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 status | Workflow status | JSON | ZIP | XML | |
|---|---|---|---|---|---|
completed | completed | ✅ | ✅ | ✅ | ✅ |
inconsistent_data | completed | ✅ | ❌ | ❌ | ✅ |
invalid_data | failed | ✅ | ❌ | ❌ | ✅ |
new / pending | new / 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.
flowVariant | Client completed |
|---|---|
eIDVerification | eID |
DocumentVerification | Verification 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.taxusing 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:
| Field | Meaning |
|---|---|
countrySubjectToTaxation | ISO 3166-1 alpha-3, uppercase, for example ESP |
tin | Client tax identification number |
usPerson | Whether the client is a U.S. person. |
usTin | U.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
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.
| Section | Contents |
|---|---|
| Cover page | Workflow outcome, identifiers, timestamps, configured products, and recommended actions |
| Disclaimer | Terms and conditions for the generated report |
| Checks overview | High-level summary of the areas that were checked |
| Personal data | Extracted and corrected identity data |
| Tax information | Country of taxation and TIN information |
| Identity files | Uploaded identity files and extracted document data |
| Risk category | Final workflow risk assessment |
| Agent details | Processing and review agent information |
| AML screening | Screening databases, hit types, and review outcomes |
| Identity media | Selfies, document images, videos, and security feature assessments |
| Document address | Address extracted from the ID document |
| Document type | Document type extracted from the ID document, for example Passport or National ID Card |
| Document issuing country | Issuing country extracted from the ID document. Format: ISO 3166-1 alpha-3 |
| Document expiration date | Expiration 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
| Attribute | Description |
|---|---|
SafenedKYC | The 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
| Attribute | Description |
|---|---|
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
| Attribute | Description |
|---|---|
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
| Attribute | Description |
|---|---|
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
| Attribute | Description |
|---|---|
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
| Attribute | Description |
|---|---|
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
| Attribute | Description |
|---|---|
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.
| Attribute | Description |
|---|---|
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
ClientNumberProvideris 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>
Updated about 2 hours ago