Reference Data

Reference schemas for counterparty and geotag data used across the solution.

The following are reference datasets that we will reference throughout the solution.

FieldTypeOptionalDescription
l3CounterpartyIdStringNoUnique identifier for the counterparty. Type 4 or type 5 UUID for “core” engine counterparties and a type 3 UUID for counterparties derived from geotag data.
l3CounterpartyNameStringNoThe name of the counterparty: L3 brand.
parentIdStringYesFor counterparties that provide multiple services, such as Tesco, there may be numerous child counterparties for each service, e.g., Tesco Mobile, which link back to a more generic parent, i.e., Tesco.
parentNameStringYesThe name of the more generic parent counterparty.
fullCompanyNameStringYesCan be the extended name or registered name of the counterparty.
logoUrlStringYesURL of Moneyhub-hosted version of the counterparty logo. Suitable for displaying in a consumer-facing app.
websiteStringYesCounterparty website.
registeredLocationStringYesAddress of the counterparty.
l2CategoryNameStringYesThe predominant level 2 category assigned to the counterparty, e.g. a petrol station, will be “gasoline”.
l3CounterpartyCategoryStringYesThe level 3 category, industry, assigned to the counterparty.
l4LoanTypeStringYesThe L4 loan type. Only present for loan provider counterparties. One of “Unsecured”, “Secured”, “Buy Now Pay Later”, “High Cost Short Term Credit”, “Debt Collection Agency/Debt Management Plan”.