Reports

Integration Guides

Fourthline’s reports provide a detailed audit trail for your risk and compliance teams, and internal and external auditors.

Identity Verification

For each Identity Verification case, we generate a specialized Client Due Diligence (CDD) Report zipfile containing:

  • A PDF report with all data and files we processed, all checks performed, the final outcome, and the risk score
  • An XML file containing all data and any corrections
  • All identity files

To download:


Zipfile structure

The zipfile structure can vary slightly, depending on the solution and how the data was uploaded. The path to the various original identity files in the zip folder is specified in the XML file.

Also, the zipfile size can vary depending on image quality and video length. The average size is approximately 40 MB.

For example:

Example zipfile structure

Example zipfile structure

PDF report

The PDF report contains the following:

ContentDescription
Cover pageThe cover page contains:
• Fourthline’s address
• Your address(es)
• The overall case outcome: Completed
• The case identifier, client identifier, final case status, and processing timestamp
• Recommended actions, e.g. when to renew the client’s identity document or when to re-verify their identity
• Additional Identity Verification modules that you use, e.g. Physical Proof of Address, Qualified Electronic Signature
DisclaimerThe terms and conditions for the CDD Report.
Checks overviewA list of all checks performed by our AI and human agents, including any significant flags raised during case processing.
Personal dataThe client’s personal data, as provided by the client and any corrections by Fourthline (e.g. typos).
For Physical Proof of Address, we provide the data extracted from the document.
Tax informationConfigurable Configurable
The country where the client is subject to tax and their TIN.
Identity filesThe original and any corrected data for each supporting file, e.g.:
• identity document photos and video
• Selfie photo and video
• Tax information
• The official document for Physical Proof of Address, if configured
Risk scoreThe risk score for the case.
Agent detailsThe names of all Fourthline human agents who processed and reviewed the case.
AML screening• The AML database screened
• Confirmed hit or False positive: Information about the hits
• No hits: The status of the completed screening and timestamp (for your audit trail)
• Hit type: Sanctions / PEP / Adverse media / Conviction
• Outcome: Accept or Reject the client
• Recommended actions
Identity mediaCopies of all identity files provided:
• Selfie photo and a still of the selfie video
• identity document photos (original and cropped, flat and tilted) and a still of the document video
• identity document security features with AI and human agent assessments
• Physical Proof of Address document photo
Document addressConfigurable Configurable
The client’s address extracted from the identity document as raw, unverified data.
Document typeThe type of identity document, for example Passport or National ID Card.
Document issuing countryConfigurable Configurable
The issuing country extracted from the document.
Format: ISO 3166-1 alpha-3
Document expiration dateThe date the identity document expires.
Format: YYYY-MM-DD

Note

The CDD report does not contain data for the Bank Account Verification or Qualified Electronic Signature modules.


XML file

For all Identity Verification cases, we generate an XML file containing all identity data and any corrections. To download it, make a Get CDD zipfile.

The XML file is structured as follows and may contain:

SafenedKYC
AttributeDescription
SafenedKYCThe container for the XML file.
ClientNumberProvider
Type: String
The Fourthline clientId.
ModifiedDateTime
Type: Datetime
The timestamp for when the XML file was last modified.
Format: ISO 8601 YYYY-MM-DDThh:mm:ssZ without milliseconds
Provider
Type: String
Your name in Fourthline's system agreed with your Fourthline delivery manager.
Identification

Identification is an array of objects containing 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 the client is:
• Legal Entity: The client is a company or organization with legal rights and obligations.
• Legal Person: The client is a non-human entity with legal rights and obligations.
• Natural Person: The client is a living human.
AcademicTitle
Type: String
The client’s academic or honorific title, for example: PROF, Dr., -ing, Mag.. The value is extracted as-is from the identity document (not normalised). The value may contain the following special characters:
• . (dot)
• - (hyphen)
If no value is available, this field is set to N/A.
If the value is available but cannot be extracted, this field is set to [NOT PROVIDED].
This field is only applicable for certain identity documents from Austria and Germany.
Name
Type: String
The client's full name.
Initials
Type: String
The client's initials.
FirstName
Type: String
The client's first name.
If no value is inputted or extracted, this field is set to [NOT PROVIDED].
MiddleName
Type: String
The client's first name.
LastName
Type: String
The client's last name.
If no value is inputted or extracted, this field is set to [NOT PROVIDED].
OtherLastName
Type: String
Any other last name the client uses, e.g. married name.
Format: Alphabetical characters, spaces, hyphens, and apostrophes
If no value is available, this field is set to N/A.
If the value is available but cannot be extracted, this field is set to [NOT PROVIDED].
ConfigurableConfigurable:
You can configure a Fourthline human agent to perform a matchOtherLastName check and, if necessary, correct it.
This value is always included in the CDD Report. You can configure to also include it in the XML or JSON response in the case zipfile.
Nationality
Type: String
The client's nationality.
Format: ISO 3166-1 alpha-3
If no value is available, this field is set to N/A.
If no value is inputted or extracted, this field is set to [NOT PROVIDED].
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.
If no value is available, this field is set to N/A.
If no value is inputted or extracted, this field is set to [NOT PROVIDED].
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: int32
The street number of the address.
StreetNumberSuffix
Type: String
The suffix of the street number.
Example: 123A
PostalCode
Type: String
The zip code of the client's address.
Region
Type: String
The region of the client's address.
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.
Mobile
Type: String
The client's mobile phone number.
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:
• Business Card
• Document Video
• Driving License
• Embedded Face
• Health Insurance Card
• IBAN Statement
• National ID Card
• Other
• Paper ID
• Passport
• Proof of Residence
• Residence Permit
• Selfie
• Selfie Video
• SSN Reference Document
• Student ID Card
• TIN Reference Document
DocumentSubType
Type: String
For Physical Proof of Address, any further sub-classification of this document type.
DocumentNumber
Type: String
The identity document number.
DocumentIssuingCountry
Type: String
If configured, the country that issued the identity document.
Format: ISO 3166-1 alpha-3
Files
Type: Object
The container for the identity file photos/videos.
Files.File
Type: Object
The container for each photo/video.
Files.File.
FileLocation
Type: String
The location of the photo/video relative to the XML file within the zipfile.
Files.File.
Side
Type: String
The side of the identity document shown.
• Back
• Front
• InsideLeft
• InsideRight
Files.File.
FileType
Type: String
The type of file.
Example: JPEG
Files.File.
Latitude
Type: String
The latitude of the document photo.
Files.File.
Longitude
Type: String
The longitude of the document photo.
IssueDate
Type: Date
The date the identity document was issued.
Format: YYYY-MM-DD
ExpirationDate
Type: Date
The date the identity document expires.
Format: YYYY-MM-DD
ResidenceAddress
Type: String
The residence address extracted from the identity document. Returns N/A if no address is available or if the check is not configured.
ValidityInDays
Type: Integer
For Physical Proof of Address, the number of days the document is valid for.
HolderName
Type: String
For Physical Proof of Address, the name of the person the document was issued to.
EmbeddedData
Type: Object
The data from the NFC chip, if present.
EmbeddedData.MRZ
Type: String
The data from the MRZ.
EmbeddedData.EncodedFace
Type: Object
The portrait from the NFC chip.
EmbeddedData.EncodedFace.
Files
Type: Array of objects
The container for the EncodedFace files.
EmbeddedData.EncodedFace.
Files.File
Type: Object
The container for each EncodedFace file.
EmbeddedData.EncodedFace.
Files.File.FileLocation
Type: String
The location of the EncodedFace file relative to the XML file within the zipfile.
EmbeddedData.EncodedFace.
Files.File.FileType
Type: String
The type of file.
Example: JPEG
EmbeddedData.EncodedFace.
Files.File.Latitude
Type: String
The latitude of the document photo.
EmbeddedData.EncodedFace.
Files.File.Longitude
Type: String
The longitude of the document photo.
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
TIN
Type: Integer
The client's tax identification number.
If no value is available, this field is set to N/A.
If no value is inputted or extracted, this field is set to [NOT PROVIDED].
USPerson
Type: String
Whether the client is a US citizen.
USTIN
Type: String
The client's US tax identification number.
Profession
AttributeDescription
Profession
Type: Object
The client's profession and employment situation.
Employment
Type: String
The client's employment status.
• no: The client isn't employed.
• self-employed: The client is self-employed.
• yes: The client is employed.
Profession
Type: String
What the client does for work.
Industry
Type: String
The industry the client works in.
• A: Agriculture, forestry, and fishing
• B: Mining and quarrying
• C: Manufacturing
• D: Electricity, gas, stream, and air conditioning supply
• E: Water supply; sewerage, waste management and remediation activities
• F: Construction
• G: Wholesale and retail trade; repair of motor vehicles and motorcycles
• H: Transportation and storage
• I: Accommodation and food service activities
• J: Information and communication
• K: Financial and insurance activities
• L: Real estate activities
• M: Professional, scientific and technical activities
• N: Administrative and support service activities
• O: Public administration and defense; compulsory social security
• P: Education
• Q: Human health and social work activities
• R: Arts, entertainment and recreation
• S: Other service activities
• T: Activities of households as employers; undifferentiated goods and services-producing activities
• U: Activities of extraterritorial organizations and bodies
DeviceMetaData
AttributeDescription
IpAddress
Type: String
The IP address of the client's device.
RiskRequirements
AttributeDescription
RiskRequirements
Type: Array
Specific risk factors for Italian clients.
Entity
Type: String
The country that requires this data.
Product
Type: String
The type of product the client produces.
Sector
Type: String
The industry where the client is active.
PlaceOfWork
Type: String
The place where the client works.
SourceOfIncome
Type: String
Where the client gets their income from.
PepSelfDeclared
Type: String
Whether the client has declared that they are a PEP.

Example XML code

<?xml version="1.0" encoding="utf-8"?>
<SafenedKYC xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" Provider="QA" ClientNumberProvider="Analyst portal workflow  No hits  All cards green_1903491600" ModifiedDateTime="2026-05-12T22:00:00Z">
  <Identification>
    <Person>
      <Type>Natural Person</Type>
      <AcademicTitle>N/A</AcademicTitle>
      <Name>WILLEKE LISELOTTE DE BRUIJN</Name>
      <Initials>WB</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>Honthorstlaan</Street>
      <StreetNumber>150</StreetNumber>
      <StreetNumberPrefix></StreetNumberPrefix>
      <StreetNumberSuffix></StreetNumberSuffix>
      <PostalCode>1816 TH</PostalCode>
      <Region></Region>
      <City>Alkmaar</City>
      <Country>NLD</Country>
    </Address>
    <EmailAndPhone>
      <Email>[email protected]</Email>
      <Phone>+31681999929</Phone>
      <Mobile>+31681999929</Mobile>
    </EmailAndPhone>
    <Documents>
      <IdentificationDocument>
        <DocumentType>Passport</DocumentType>
        <DocumentNumber>SPECI2021</DocumentNumber>
        <DocumentIssuingCountry>NLD</DocumentIssuingCountry>
        <Files>
          <File>
            <FileLocation>Documents/passport.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>Selfie</DocumentType>
        <Files>
          <File>
            <FileLocation>Documents/selfie1.jpg</FileLocation>
            <Side>Front</Side>
            <FileType>JPG</FileType>
          </File>
        </Files>
        <IssueDate>2019-08-29</IssueDate>
        <ExpirationDate>2025-08-28</ExpirationDate>
        <ResidenceAddress>N/A</ResidenceAddress>
      </IdentificationDocument>
    </Documents>
    <Tax>
      <CountrySubjectToTaxation>DNK</CountrySubjectToTaxation>
      <TIN>1234567</TIN>
      <USPerson>False</USPerson>
      <USTIN></USTIN>
    </Tax>
  </Identification>
  <Location>
    <Latitude>52.563457</Latitude>
    <Longitude>6.367457</Longitude>
  </Location>
  <Profession>
    <Employment></Employment>
    <Profession></Profession>
    <Industry></Industry>
  </Profession>
</SafenedKYC>

Biometric Authentication

Note

Client Authentication has been renamed to Biometric Authentication. This is a terminology change only—Biometric Authentication is supported in both v1 and v2 integrations.

For each Biometric Authentication case, we generate a CDD Report in PDF format.

To download the report, make a Get CDD PDF request. The report contains the following:

ContentDescription
OutcomeCompleted
Case detailsCase identifier and case status
AddressesFourthline's address and your address(es)
Data• The client’s personal data, as originally entered by the client and any corrections by Fourthline
• The client's tax information
ProcessingThe status code history for the case, explaining the outcome and any flags raised during case processing
Risk scoreThe risk score for the case:
Low (acceptable) or Unacceptable
AgentsThe names of all Fourthline human agents who processed and reviewed the case

Document Authentication

For each Document Authentication case, we generate a CDD Report in PDF format.

To download the report, make a Get CDD PDF request.

The report contains the following:

ContentDescription
OutcomeCompleted
Case detailsCase identifier and case status
AddressesFourthline's address and your address(es)
DataThe client’s personal data:
• As originally entered by the client and any corrections by Fourthline
• From their latest successful Identity Verification case
The document data for the client’s primary identity document, and any corrections by Fourthline
ProcessingThe status code history for the case, explaining the outcome and any flags raised during case processing
Risk scoreThe risk score for the case:
Low (acceptable) or Unacceptable
AgentsThe names of all Fourthline human agents who processed and reviewed the case
Files• Copies of all identity document photos (original and cropped, flat and tilted)
• All data including any corrections in an XML file
• All identity document photos
Tax informationIf collected, the country where the client is subject to tax and their TIN.

AML Screening & Monitoring

For AML Screening & Monitoring, for every confirmed hit, we generate a Confirmed Hit Report.

To download the report, make a Get Confirmed Hit Report request.

The report contains the following:

ContentDescription
Personal dataThe client’s personal data and any aliases, known locations and companies
Investigation data• Investigation identifier
• Key words
• Date of the database entry and any updates
• Any additional information from the investigation
Example report

Example Confirmed Hit Report