Product Finder

Retrieve Financial Products V2

The GET /insights/v2/products endpoint provides a list of a customer's financial products based on their previous transactions.

📘
Please note financial products are only identified from debit transactions. Additionally, if the from and to parameters are not set the endpoint will default to only analysing transactions from the last six months.

This endpoint will return a list of the given customer's financial products. An example of a 200 response can be seen below.

{
  "operation_id": "insights_v2_products",
  "data": [
    {
      "type": [
        "credit_card"
      ],
      "merchant": {
        "id": "nationwidebuildingsociety",
        "logo": "https://assets.thisisbud.com/bud-datasci-images/merchant_logos/e121c7aa-a254-41bb-ad3e-33b988f791be/v1/nationwidebuildingsociety.jpeg",
        "name": "Nationwide Building Society"
      },
      "amount": {
        "value": "0.03",
        "currency": "GBP"
      },
      "period": "unknown"
    },
    {
      "type": [
        "insurance"
      ],
      "merchant": {
        "id": "aviva",
        "logo": "https://assets.thisisbud.com/bud-datasci-images/merchant_logos/c50be401-7891-44c5-9fed-535080e77c57/v1/aviva.jpeg",
        "name": "Aviva"
      },
      "amount": {
        "value": "59.99",
        "currency": "GBP"
      },
      "period": "monthly"
    }
  ],
  "metadata": {
    "from": "2022-09-03T11:28:22.00Z",
    "to": "2023-03-03T11:28:22.00Z",
    "results": 2
  }
}

curl --request GET \
     --url https://api-sandbox.thisisbud.com/insights/v2/products \
     --header 'X-Client-Id: <client_id>' \
     --header 'X-Customer-Id: <customer_id>' \
     --header 'X-Customer-Secret: <customer_secret>' \ # Not required for hosted customers
     --header 'accept: application/json'

This response will contain a list of a customer's financial products including information about the type, merchant, amount and period. Currently, the following types are supported:

Loans
Buy Now, Pay Later (BNPL)
Mortgages
Insurance Products
Credit Cards
Private Pensions
Savings and Investments

If you receive a 400 response like below, please check the headers you're sending in the request before trying again.

{
  "operation_id": "insights_v2_products",
  "code_id": "failed_validation",
  "message": "Invalid request payload.",
  "errors": [
    "invalid 'from' date: '7th March 2023'"
  ]
}

A 401 response would indicate that you are not authorised to make this request, if you believe this to be a mistake or are receiving persistent 500 responses please raise a support request support request.

If you have any questions, please contact us via the chatbot (bottom-right of screen 👉) or via a support request or check our FAQs.