Fetch FI Data API

The notification URL you have configured with Setu will be used to notify you when data is ready to be fetched.

Use the id received in Create Data Session API in the previous step to call this API to fetch the financial information of your user.

Request

If you request for multiple FI types, you will receive all the FI data from end-user's linked accounts in an array.

{
    "ver": "1.1.2",
    "txnid": "9623a5d0-3b01-4548-babf-be58f5463ce3",
    "timestamp": "2024-03-06T14:02:41.197Z",
    "FI": [
        {
            "fipID": "fip@fincaresfbuat",
            "data": [
                {
                    "linkRefNumber": "6100b7a2-57a2-42c7-a910-ce184acc89ab",
                    "maskedAccNumber": "XXXXXXXXXX5631",
                    "encryptedFI": "/VQSpnPQtW3AhSKbebsVIPLn087gSR4mOIlEsC7kIar5XnBJV2sfAd6fa/SBzHbibi9v4Xv0FiqMf1UODNiVNAb4rz0NIdTF8q3CHrPuzH8KkVLPfRAGYdr9zmPnrvv/em0BJ8M1/SpYQZzmtB5H1Ozj/fi+g40VcSUz/knombGRExbeON3sXOeZzTUlgO6nHDIfrnPcMPFzgJdPTVeW8b+oH7fmGk3nKgIsiuN/ODyjhZwqAGWF2G3K47WwwhGn8k3JpE3vLq1gi6HWGSQnG/qe0iQkpfRyv+ZOH9pdv7MbfQ20t7OOwbOflh8AggtPRk42GJyEctLPhzClVJFiE6rsRQQkWroUoLJzcadivhu24PwVsnFKszuij9jsk4hSl0MgM3JQ1/Jg3p3e6+QzJUl6tsOh5+Kc1uE9G+596wwZyt9dwE3xeFIWC6a0+89vKCQ5mHxyzPLmzO9EkaM3LBmeQbDBSRC++JRKcSyEnhP05DZagjrr49WgBTxrMzzAHz9NtN382LSorAuK4lG/+AELcVT/km9Iy1mpC8M2tCI/6Z8KuGm+MDB0vdgfv0cGmbZQAcrF1DSC3EL19ujUfTqx2mMAtYetFcsIc3zUyNjNaxyKWDRZiCWZrnh8K6VjJWi4RCpzZmsMzz4RX/JMvV/VU4xQMrqvp5ZM5dkQrCNVlWBaCOPI45II4Oly05whspxNvRn7lSR1BpaS6WG2B9t01dw1MlERNHfg8tr2PeJBT6JJPe18sxElN+ma7s0qIhKlhUScupWisjO9pX7RlrrVSxzuNwElDrV3zAuc8azPGc9Px+hnxavs57slqeCR0NSpCiqcu41nWdcr1KPv5X9WL1nHX6gB1iQk4b0UMMzZVnoxG7Z7SRHGTxeJbiF9IdV9OwAB34MxvZEofUEY4TKNHpkGJaLhBNtDDqMxRzvZ/p4gA8OgKHCk6UKMYrXBpBVpQ/kfpZyl2MtimMz+uIc5pD/WkWbLq//T8hd6Hbk9IUrlzKiT7tekdYwVDzBoZMPnvnN/RgcF3sCataBDpQeEcJi0UhNQPAI2Q4j1fhYqfDvnd+4sruDYbZCfuQKLFBr3ndvUIQ2XJaUudQbSLt0oROR4SmzACBYIYcGagnwsmz4xeKfdFnZkqPFeP8FXVozeeKiyQFYvazoB49WOnWAc00HMzPa2YK3XQJtB9wE8Kp9bGA=="
                }
            ],
            "KeyMaterial": {
                "cryptoAlg": "ECDH",
                "curve": "Curve25519",
                "params": "None",
                "DHPublicKey": {
                    "expiry": "2024-03-07T14:02:30.543Z",
                    "Parameters": "None",
                    "KeyValue": "-----BEGIN PUBLIC KEY-----MIIBMTCB6gYHKoZIzj0CATCB3gIBATArBgcqhkjOPQEBAiB/////////////////////////////////////////7TBEBCAqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqYSRShRAQge0Je0Je0Je0Je0Je0Je0Je0Je0Je0Je0JgtenHcQyGQEQQQqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq0kWiCuGaG4oIa04B7dLHdI0UySPU1+bXxhsinpxaJ+ztPZAiAQAAAAAAAAAAAAAAAAAAAAFN753qL3nNZYEmMaXPXT7QIBCANCAAROLRX0c9Dpd5jRPpOgJKVnrU/43KLaTDLlu+WDh4tk50Y1ydUgIJzlsitKoLP2VdlibPr2XP+rWsyfo0HMCSGS-----END PUBLIC KEY-----"
                },
                "Nonce": "/2k5nyz1f3+WqMT0OWA20lsupdvBgQQVkpFpZGUrUAE="
            }
        }
    ]
}

Response

The response comes with status:

COMPLETED which signifies that FI data fetch is completed for the requested session.
PARTIAL which signifies that some FIP FI data fetches are completed and some have failed for the requested session.
PENDING which signifies that some FIP FI data fetches are completed and some are still pending for the requested session.

The payload contains Profile, Summary and Transactions as requested in Create consent request.

{
    "ver": "1.1.2",
    "timestamp": "2024-03-06T14:02:29.773+00:00",
    "txnid": "c6b4550c-7088-4b29-aa47-53a82eb6d152",
    "consentId": "c3b077f0-d111-4457-b6ba-90cf62c48d9f",
    "sessionId": "7fb9745f-05be-457a-85cc-465df677f3ed"
}

Create Data Session Notifications