FIU service - public

Consent APIs

POSTCreate new consent

https://fiu-uat.setu.co/consents

Call this API to create a consent request. Update Customer.id with your mobile number to be able to test the flow. This API responds with a url to initiate consent review flow as part of the response, with consent status as PENDING.
Read more about Consent Review by Customer here(https://docs.setu.co/data/account-aggregator/api-integration/consent-flow#consent-review-by-customer)

HEADERS

x-client-id

test-client

x-client-secret

3fa14d45-3adc-4522-b512-1e3f24d92568

Bodyraw (json)

json

{
    "Detail": {
        "consentStart": "2025-04-03T10:43:51.425Z",
        "consentExpiry": "2023-04-23T05:44:53.822Z",
        "Customer": {
            "id": "9999999999@onemoney"
        },
        "FIDataRange": {
            "from": "2021-04-01T00:00:00Z",
            "to": "2021-10-01T00:00:00Z"
        },
        "consentMode": "STORE",
        "consentTypes": [
            "TRANSACTIONS",
            "PROFILE",
            "SUMMARY"
        ],
        "fetchType": "PERIODIC",
        "Frequency": {
            "value": 30,
            "unit": "MONTH"
        },
        "DataFilter": [
            {
                "type": "TRANSACTIONAMOUNT",
                "value": "5000",
                "operator": ">="
            }
        ],
        "DataLife": {
            "value": 1,
            "unit": "MONTH"
        },
        "DataConsumer": {
            "id": "setu-fiu-id"
        },
        "Purpose": {
            "Category": {
                "type": "string"
            },
            "code": "101",
            "text": "Loan underwriting",
            "refUri": "https://api.rebit.org.in/aa/purpose/101.xml"
        },
        "fiTypes": [
            "DEPOSIT"
        ]
    },
    "context": [
        {
            "key": "accounttype",
            "value": "CURRENT"
        }
    ],
    "redirectUrl": "https://setu.co"
}

Example Request

curl

curl --location 'https://fiu-uat.setu.co/consents' \
--header 'x-client-id: test-client' \
--header 'x-client-secret: 3fa14d45-3adc-4522-b512-1e3f24d92568' \
--data-raw '{
    "Detail": {
        "consentStart": "2025-04-03T10:43:51.775Z",
        "consentExpiry": "2023-04-23T05:44:53.822Z",
        "Customer": {
            "id": "9999999999@onemoney"
        },
        "FIDataRange": {
            "from": "2021-04-01T00:00:00Z",
            "to": "2021-10-01T00:00:00Z"
        },
        "consentMode": "STORE",
        "consentTypes": [
            "TRANSACTIONS",
            "PROFILE",
            "SUMMARY"
        ],
        "fetchType": "PERIODIC",
        "Frequency": {
            "value": 30,
            "unit": "MONTH"
        },
        "DataFilter": [
            {
                "type": "TRANSACTIONAMOUNT",
                "value": "5000",
                "operator": ">="
            }
        ],
        "DataLife": {
            "value": 1,
            "unit": "MONTH"
        },
        "DataConsumer": {
            "id": "setu-fiu-id"
        },
        "Purpose": {
            "Category": {
                "type": "string"
            },
            "code": "101",
            "text": "Loan underwriting",
            "refUri": "https://api.rebit.org.in/aa/purpose/101.xml"
        },
        "fiTypes": [
            "DEPOSIT"
        ]
    },
    "context": [
        {
            "key": "accounttype",
            "value": "CURRENT"
        }
    ],
    "redirectUrl": "https://setu.co"
}'

Example Response

No response body

This request doesn't return any response body

No response headers

This request doesn't return any response headers

GETGet a consent

https://fiu-uat.setu.co/consents/:id

Call this API to get the updated status of a consent request by passing its unique id. If the consent is approved, the Status in the response will be ACTIVE. After this, you can now initiate Data flow for the approved consent request.