Get All FI Data

A valid request URL is required to generate request examples

{
  "ver": "1.21.0",
  "status": "success",
  "data": [
    {
      "linkReferenceNumber": "e72534d6-0016-4f0e-9da5-3e05ad405394",
      "maskedAccountNumber": "XXXXXXXX3900",
      "fiType": "DEPOSIT",
      "bank": "FinShareBankServer",
      "Profile": {
        "Holders": {
          "type": "SINGLE",
          "Holder": [
            {
              "name": "John Doe",
              "dob": "1990-01-01",
              "mobile": "9876543210",
              "nominee": "NOT-REGISTERED",
              "landline": "",
              "address": "12 MG Road, Bengaluru",
              "email": "john.doe@example.com",
              "pan": "ABCDE1234F",
              "ckycCompliance": "true"
            }
          ]
        }
      },
      "Summary": {
        "currentBalance": "45000.00",
        "currency": "INR",
        "exchgeRate": "",
        "balanceDateTime": "2023-01-31T10:00:00.000Z",
        "type": "SAVINGS",
        "branch": "MG Road",
        "facility": "",
        "ifscCode": "HDFC0001234",
        "micrCode": "560240002",
        "openingDate": "2015-06-01",
        "currentODLimit": "0",
        "drawingLimit": "0",
        "status": "ACTIVE",
        "Pending": []
      },
      "Transactions": {
        "startDate": "2023-01-01",
        "endDate": "2023-01-31",
        "Transaction": [
          {
            "type": "CREDIT",
            "mode": "UPI",
            "amount": "5000.00",
            "currentBalance": "45000.00",
            "transactionTimestamp": "2023-01-15T10:30:00.000Z",
            "valueDate": "2023-01-15",
            "txnId": "UPI123456789",
            "narration": "Payment received from XYZ",
            "reference": "REF123456"
          }
        ]
      }
    }
  ]
}

POST

getallfidata

A valid request URL is required to generate request examples

{
  "ver": "1.21.0",
  "status": "success",
  "data": [
    {
      "linkReferenceNumber": "e72534d6-0016-4f0e-9da5-3e05ad405394",
      "maskedAccountNumber": "XXXXXXXX3900",
      "fiType": "DEPOSIT",
      "bank": "FinShareBankServer",
      "Profile": {
        "Holders": {
          "type": "SINGLE",
          "Holder": [
            {
              "name": "John Doe",
              "dob": "1990-01-01",
              "mobile": "9876543210",
              "nominee": "NOT-REGISTERED",
              "landline": "",
              "address": "12 MG Road, Bengaluru",
              "email": "john.doe@example.com",
              "pan": "ABCDE1234F",
              "ckycCompliance": "true"
            }
          ]
        }
      },
      "Summary": {
        "currentBalance": "45000.00",
        "currency": "INR",
        "exchgeRate": "",
        "balanceDateTime": "2023-01-31T10:00:00.000Z",
        "type": "SAVINGS",
        "branch": "MG Road",
        "facility": "",
        "ifscCode": "HDFC0001234",
        "micrCode": "560240002",
        "openingDate": "2015-06-01",
        "currentODLimit": "0",
        "drawingLimit": "0",
        "status": "ACTIVE",
        "Pending": []
      },
      "Transactions": {
        "startDate": "2023-01-01",
        "endDate": "2023-01-31",
        "Transaction": [
          {
            "type": "CREDIT",
            "mode": "UPI",
            "amount": "5000.00",
            "currentBalance": "45000.00",
            "transactionTimestamp": "2023-01-15T10:30:00.000Z",
            "valueDate": "2023-01-15",
            "txnId": "UPI123456789",
            "narration": "Payment received from XYZ",
            "reference": "REF123456"
          }
        ]
      }
    }
  ]
}

Overview

The Get All FI Data API allows you to download complete financial information in JSON format for all accounts associated with a specific consent. This API provides comprehensive access to financial data including account profiles, transaction histories, balances, and account holder information. It supports all Financial Information (FI) types that are active in the Account Aggregator ecosystem.

Key Use Cases

Complete Data Retrieval: Download all available financial data linked to a given consent in a structured JSON format.
Transaction Filtering: Optionally filter transactions by specifying a custom date range to retrieve only relevant transaction data.
Multi-Account Support: Retrieve data for all accounts linked to a consent in a single API call.
All FI Types: Supports various financial information types including Deposit accounts, Mutual Funds, Equities, Insurance, and more.

Important Notes

Data will only be returned if it is available in FinPro. You must first successfully complete the FI Request and ensure the status shows DATA_READY before calling this API.
The requested data must align with the parameters and scope specified in the approved consent.
If you need data in PDF format instead of JSON, use the Get All FI Data PDF API.
For periodic/recurring consents, this API returns cumulative data. To get only incremental data since the last fetch, use the Get All Latest FI Data API instead.

Authentication

This API requires authentication using the following headers:

string

required

Your unique client identifier provided by FinPro during onboarding. This ID is used to authenticate your application.

string

required

Your confidential client secret key provided by FinPro. This must be kept secure and never exposed in client-side code.

string

required

The unique identifier for your application (e.g., your application’s package name or bundle ID). This helps FinPro identify which application is making the request.

string

required

Your organization’s unique identifier assigned by FinPro. This identifies your organization in the FinPro system.

string

required

Must be set to application/json to indicate that the request body contains JSON data and that the response will be in JSON format.

Query Parameters

The following optional query parameters can be used to control the pagination of results:

boolean

When set to true, limits the number of records returned in the response. This is useful for handling large datasets.

boolean

When set to true, offsets the starting point of records. Use this in combination with limit for pagination.

Example: ?limit=true&offset=true

Request Body

The unique consent identifier provided by the Account Aggregator after consent approval. This must be a valid GUID format. Only alphanumeric characters, underscores (_), hyphens (-), and periods (.) are allowed.

string

The start date from when transaction data is required. Must be in ISO 8601 UTC date format (e.g., 2023-01-01T00:00:00Z). When provided, only transactions on or after this date will be included in the response.

string

The end date until when transaction data is required. Must be in ISO 8601 UTC date format (e.g., 2023-01-31T23:59:59Z). When provided, only transactions on or before this date will be included in the response.

Request Example

{
  "consentID": "84001bb6-b1d0-4443-aeff-dd482255a058"
}

Request Example with Transaction Date Filtering

{
  "consentID": "84001bb6-b1d0-4443-aeff-dd482255a058",
  "transactionsStartDate": "2023-01-01T00:00:00Z",
  "transactionsEndDate": "2023-01-31T23:59:59Z"
}

Response Parameters

string

The version of the API that processed the request.

string

The overall status of the API response. Returns "success" when data is retrieved.

string

A note from the server. Sent only when it is not empty (for example "No data Found").

array

An array of account objects. Each object is one account linked to the consent.

Show data array item properties

string

required

The unique linked reference number for this account. This identifier ties the account data to a specific account authorization.

string

required

The masked account number (e.g., XXXXXXXX3900). The full account number is never returned.

string

required

The type of financial information. Supported values include:

DEPOSIT: Savings and current accounts
TERM_DEPOSIT, TERM-DEPOSIT: Fixed deposit accounts
RECURRING_DEPOSIT: Recurring deposit accounts
SIP: Systematic Investment Plans
MUTUAL_FUNDS: Mutual fund holdings
EQUITIES: Equity/stock holdings
BONDS, DEBENTURES: Bond and debenture investments
ETF: Exchange Traded Funds
INSURANCE_POLICIES: Insurance policies
LIFE_INSURANCE, GENERAL_INSURANCE: Specific insurance types
NPS: National Pension Scheme
GSTR1_3B: GST returns
And other types as per the ReBIT FI Schema

string

required

The name of the financial institution (bank or Financial Information Provider) that holds this account.

object

Account holder details. For DEPOSIT accounts it has the shape below. For other FI types it follows the ReBIT schema of that FI type. Empty object ({}) when not available.

Show Profile properties (DEPOSIT)

object

Show Holders properties

string

Holding type, e.g. SINGLE or JOINT.

array

One object per account holder with these fields: name, dob, mobile, nominee, landline, address, email, pan, ckycCompliance.

object

Account summary. For DEPOSIT accounts it has the fields below. For other FI types it follows the ReBIT schema of that FI type. Empty object ({}) when not available.

Show Summary properties (DEPOSIT)

string

Current balance of the account.

string

Currency code, e.g. INR.

string

Exchange rate, when the account is not in INR.

string

When the balance was taken.

string

Account type, e.g. SAVINGS or CURRENT.

string

Branch name.

string

Facility, e.g. OD or CC.

string

IFSC code of the branch.

string

MICR code of the branch.

string

Account opening date.

string

Current overdraft limit.

string

Drawing limit.

string

Account status, e.g. ACTIVE.

array

Pending transactions, each with transactionType and amount.

object

The transaction history of the account. This list is filtered by transactionsStartDate and transactionsEndDate if you send them.

Show Transactions properties

string

Start date of the transaction period.

string

End date of the transaction period.

array

One object per transaction. For DEPOSIT accounts each has: type, mode, amount, currentBalance, transactionTimestamp, valueDate, txnId, narration, reference.

The keys Profile, Summary and Transactions start with a capital letter, and transactions are inside Transactions.Transaction. Holder details are inside Profile.Holders.Holder.

Success Response Example

{
  "ver": "1.21.0",
  "status": "success",
  "data": [
    {
      "linkReferenceNumber": "e72534d6-0016-4f0e-9da5-3e05ad405394",
      "maskedAccountNumber": "XXXXXXXX3900",
      "fiType": "DEPOSIT",
      "bank": "FinShareBankServer",
      "Profile": {
        "Holders": {
          "type": "SINGLE",
          "Holder": [
            {
              "name": "John Doe",
              "dob": "1990-01-01",
              "mobile": "9876543210",
              "nominee": "NOT-REGISTERED",
              "landline": "",
              "address": "12 MG Road, Bengaluru",
              "email": "john.doe@example.com",
              "pan": "ABCDE1234F",
              "ckycCompliance": "true"
            }
          ]
        }
      },
      "Summary": {
        "currentBalance": "45000.00",
        "currency": "INR",
        "exchgeRate": "",
        "balanceDateTime": "2023-01-31T10:00:00.000Z",
        "type": "SAVINGS",
        "branch": "MG Road",
        "facility": "",
        "ifscCode": "HDFC0001234",
        "micrCode": "560240002",
        "openingDate": "2015-06-01",
        "currentODLimit": "0",
        "drawingLimit": "0",
        "status": "ACTIVE",
        "Pending": []
      },
      "Transactions": {
        "startDate": "2023-01-01",
        "endDate": "2023-01-31",
        "Transaction": [
          {
            "type": "CREDIT",
            "mode": "UPI",
            "amount": "5000.00",
            "currentBalance": "45000.00",
            "transactionTimestamp": "2023-01-15T10:30:00.000Z",
            "valueDate": "2023-01-15",
            "txnId": "UPI123456789",
            "narration": "Payment received from XYZ",
            "reference": "REF123456"
          }
        ]
      }
    }
  ]
}

Error Responses

When the provided consent ID does not exist:

{
  "ver": "1.21.0",
  "timestamp": "2025-10-01T11:49:28.920Z",
  "errorCode": "InvalidConsentId",
  "errorMsg": "Consent ID does not exist."
}

HTTP Status Code: 400 Bad Request

Error Code Catalogue

Error Code	Error Message	Description	HTTP Status
`InvalidRequest`	`transactionsStartDate must be a valid ISO date`	The start date is not in valid ISO 8601 format	400
`InvalidRequest`	`consentID must be a string`	The consentID parameter is null or not a string	400
`InvalidRequest`	`transactionsEndDate must be a valid ISO date`	The end date is not in valid ISO 8601 format	400
`InvalidRequest`	`consentID value can have only A to Z, a to z, 0 to 9, _ , - and . characters`	The consentID contains invalid characters	400
`InvalidPayload`	`Either consentId or accountID should be passed and both consentID and accountID should not be passed in payload`	Missing or conflicting parameters	400
`InvalidConsentId`	`Consent ID does not exist.`	The provided consent ID is not found in the system	400
`InvalidRequest`	`Consent ID is Revoked with consent type as VIEW.`	Cannot retrieve data for a revoked VIEW-type consent	400
`NoDataAvailable`	`Data is not available for the given consent`	No financial data has been fetched for this consent yet	400
`DataIsDeleted`	`Data is deleted for this consent`	The data has expired and been deleted per data retention policy	400
`NoDataFound`	`Data is not available`	No linked accounts or data found for this consent	400
`InternalError`	`Internal Server Error : accountFIDataList`	Unexpected server error during data retrieval	500

Rate Limiting

This API is subject to rate limiting to ensure fair usage and system stability:

Rate Limit: 1000 requests per time window
Headers Returned:
- X-RateLimit-Limit: Maximum number of requests allowed
- X-RateLimit-Remaining: Number of requests remaining in current window
- X-RateLimit-Reset: Unix timestamp when the rate limit resets

If you exceed the rate limit, you will receive a 429 Too Many Requests response.

Supported FI Types

This API supports all Financial Information types defined in the ReBIT FI Schema:

Banking: DEPOSIT, TERM_DEPOSIT, TERM-DEPOSIT, RECURRING_DEPOSIT
Investments: MUTUAL_FUNDS, EQUITIES, BONDS, DEBENTURES, ETF, SIP
Government Securities: GOVT_SECURITIES, CP
Insurance: INSURANCE_POLICIES, LIFE_INSURANCE, GENERAL_INSURANCE
Pension: NPS
Alternative Investments: AIF, INVIT, REIT, IDR, CIS
Tax/GST: GSTR1_3B
Others: OTHER

Each FI type has its own specific schema structure as defined by ReBIT specifications.

Usage Flow

Verify Data Readiness: Before calling this API, use the FI Request Status API to ensure the eventStatus is DATA_READY.
Retrieve Data: Call this API with the consentID to retrieve all financial information associated with the consent.
Optional Filtering: If you only need transactions for a specific period, include the transactionsStartDate and transactionsEndDate parameters.
Process Response: Parse the JSON response to extract account information, transaction details, balances, and other financial data for your application’s use case.
Handle Multiple Accounts: The response contains an array of account objects. Process each account separately as they may have different FI types and data structures.
Data Expiry Awareness: Note that the fetched data has a limited lifetime based on the consent’s data life parameter. Plan to re-fetch data before it expires if needed.

Best Practices

Status Check First: Always verify that data is ready using the FI Request Status API before attempting to retrieve it. Calling this API when data is not ready will result in a NoDataAvailable error.
Transaction Filtering: When you only need recent transactions, use the transactionsStartDate and transactionsEndDate parameters to reduce payload size and improve performance.
Handle Different FI Types: Different FI types have different data structures. Implement flexible parsing logic to handle various FI type schemas as per ReBIT specifications.
Error Handling: Implement comprehensive error handling for all error codes, especially:
- NoDataAvailable: Indicates you need to wait longer or initiate an FI request
- DataIsDeleted: Indicates data has expired and you need to fetch fresh data
- InvalidConsentId: Indicates the consent may be invalid, expired, or revoked
Data Persistence: Store the retrieved financial data in your system with appropriate security measures. Do not rely on fetching data repeatedly as it may be deleted after the data life period.
Pagination: For consents with large amounts of data, use the limit and offset query parameters to implement pagination and avoid timeout issues.
Schema Validation: Validate the received data against the ReBIT FI Schema to ensure data integrity before processing.
Consent Scope: Ensure you only request and process data that falls within the scope approved by the user in the consent.
Security: Always transmit and store financial data securely. Use HTTPS for API calls and encrypt data at rest in your systems.

Authorizations

client_id

string

header

required

Your unique client identifier provided by MoneyOne during FIU onboarding

client_secret

string

header

required

Your confidential client secret provided by MoneyOne

organisationId

string

header

required

Your organization's unique identifier in the FinPro system

appIdentifier

string

header

required

Application-specific identifier for tracking API calls

Query Parameters

limit

boolean

When set to true, limits the number of records returned in the response. This is useful for handling large datasets.

offset

boolean

When set to true, offsets the starting point of records. Use this in combination with limit for pagination.

Body

application/json

The unique consent identifier (UUID) for which you want to retrieve financial information. This must be an ACTIVE consent that has already been approved by the customer and for which data has been fetched.

transactionsStartDate

string<date-time>

Optional ISO 8601 date-time filter to retrieve transactions starting from this date. Use this to limit the transaction history to a specific time range. Must be within the consent's approved data range.

transactionsEndDate

string<date-time>

Optional ISO 8601 date-time filter to retrieve transactions up to this date. Use in combination with transactionsStartDate to define a specific date range. Must be within the consent's approved data range.

Response

Financial data retrieved successfully

ver

string

The version of the FinPro API that processed this request.

status

string

Overall API call status. Will be 'success' for successful requests.

message

string

A note from the server. Sent only when it is not empty (for example 'No data Found').

data

object[]

An array of financial account data objects. Each object represents one linked account under the consent.

Show child attributes

Consent Management

Data Management

Bulk Operations

Web Redirection

User Management

Analytics

Miscellaneous

Overview

Key Use Cases

Important Notes

Authentication

Query Parameters

Request Body

Request Example

Request Example with Transaction Date Filtering

Response Parameters

Success Response Example

Error Responses

Error Code Catalogue

Rate Limiting

Supported FI Types

Usage Flow

Best Practices

Authorizations

Query Parameters

Body

Response

​Overview

​Key Use Cases

​Important Notes

​Authentication

​Query Parameters

​Request Body

​Request Example

​Request Example with Transaction Date Filtering

​Response Parameters

​Success Response Example

​Error Responses

​Invalid Consent ID

​Error Code Catalogue

​Rate Limiting

​Supported FI Types

​Usage Flow

​Best Practices

Authorizations

Query Parameters

Body

Response

Overview

Key Use Cases

Important Notes

Authentication

Query Parameters

Request Body

Request Example

Request Example with Transaction Date Filtering

Response Parameters

Success Response Example

Error Responses

Invalid Consent ID

Error Code Catalogue

Rate Limiting

Supported FI Types

Usage Flow

Best Practices