Skip to main content

Events Batch File

This is the data format that Qlarifi can ingest after being transferred from the lender to Qlarifi and back.

Qlarifi has been built in a way that allows for ingestion in multiple data formats. However, the current preferred data exchange is JSONL.

JSONL Format​

The following examples demonstrate JSONL files for transaction and identity events.

scenario_001_credit.jsonl

{"type": "transactionCreated", "effectiveTimestamp": "2025-02-03T00:00:00", "transactionId": "transaction-usd-001", "consumerId": "consumer1", "amount": {"number": 200.0, "currency": "USD"}, "transactionType": "PayIn4", "metadata": {"DatasetId": "b61afc4f-4b88-45fa-b2b9-d35b86bc723f"}}
{"type": "installmentIssued", "effectiveTimestamp": "2025-02-03T00:00:00", "installmentId": "installment1", "transactionId": "transaction-usd-001", "consumerId": "consumer1", "amount": {"number": 50.0, "currency": "USD"}, "dueTimestamp": "2025-02-03T00:00:00", "index": 0, "metadata": {"DatasetId": "b651f073-abd0-4ad2-bb12-45c538284065"}}
{"type": "installmentIssued", "effectiveTimestamp": "2025-02-03T00:00:00", "installmentId": "installment2", "transactionId": "transaction-usd-001", "consumerId": "consumer1", "amount": {"number": 50.0, "currency": "USD"}, "dueTimestamp": "2025-02-17T00:00:00", "index": 1, "metadata": {"DatasetId": "b651f073-abd0-4ad2-bb12-45c538284065"}}

identity_events.jsonl

{"type": "consumerIdentityCreated","effectiveTimestamp": "2024-07-10T15:00:00Z","consumerId": "consumer_1","name":{"type": "westernName","first": "Alice","last": "Smith"},"dateOfBirth": "1990-03-15","phone": "+39067891234","email": "alice.smith@email.com","address": {"type": "euAddress","streetName": "Via Edolo 46","city": "Milano","province": "MI","postalCode": "20125","country": "Italy"}}
{"type": "consumerIdentityCreated","effectiveTimestamp": "2024-07-18T11:00:00Z","consumerId": "consumer_2","name":{"type": "westernName","first": "Bob","last": "Johnson"},"dateOfBirth": "1985-11-20","phone": "+39067891234","email": "bob.johnson@email.com","address":{"type": "euAddress","streetName": "Via Edolo 46","city": "Milano","province": "MI","postalCode": "20125","country": "Italy"}}
{"type": "consumerPhoneChanged","effectiveTimestamp": "2024-08-01T10:00:00Z","consumerId": "consumer_1","phone": "+39061234567"}

This structure allows for easy processing and analysis of both transaction and identity data separately, yet linked by consumerId.

CSV Format​

# Sample data from "../samples/contribution/scenario_001/csv/scenario_001_installmentIssued.csv"
# Sample data from "../samples/contribution/scenario_001/csv/scenario_001_installmentPaid.csv"
# Sample data from "../samples/contribution/scenario_001/csv/scenario_001_transactionCreated.csv"