Pull Analytics JSON - Moneyone FinPro

Error

A valid request URL is required to generate request examples

{
  "ver": "1.21.0",
  "status": "success",
  "data": {
    "status": "SUCCESS",
    "message": "Success",
    "data": {
      "bankingAnalysis": {
        "overallAnalysis": {},
        "completeCategoryWiseAnalysis": {},
        "accountProfiles": [],
        "fcuIndicators": {},
        "bounceAnalysis": {}
      }
    }
  }
}

{
  "ver": "1.21.0",
  "timestamp": "2025-10-01T11:49:28.920Z",
  "errorCode": "InvalidRequest",
  "errorMsg": "Invalid ref_token or processing not complete",
  "status": "FP0001"
}

{
  "ver": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "errorCode": "<string>",
  "errorMsg": "<string>",
  "status": "<string>"
}

POST

analytics

pdf

pull

json

Error

A valid request URL is required to generate request examples

{
  "ver": "1.21.0",
  "status": "success",
  "data": {
    "status": "SUCCESS",
    "message": "Success",
    "data": {
      "bankingAnalysis": {
        "overallAnalysis": {},
        "completeCategoryWiseAnalysis": {},
        "accountProfiles": [],
        "fcuIndicators": {},
        "bounceAnalysis": {}
      }
    }
  }
}

{
  "ver": "1.21.0",
  "timestamp": "2025-10-01T11:49:28.920Z",
  "errorCode": "InvalidRequest",
  "errorMsg": "Invalid ref_token or processing not complete",
  "status": "FP0001"
}

{
  "ver": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "errorCode": "<string>",
  "errorMsg": "<string>",
  "status": "<string>"
}

Overview

The Pull Analytics JSON API is the final step in the PDF Analytics flow. After the PDF processing is complete (confirmed via the Pull Status API), use this endpoint to retrieve the analytics results in JSON format. The response contains comprehensive banking analytics derived from the uploaded bank statement PDFs, similar to the Analytics JSON API output.

PDF Analytics Flow

Push PDF

Upload bank statement PDFs using the Push PDF API. Receive a ref_token.

Check Status

Poll the Pull Status API until processing is complete.

Pull Analytics JSON (this API)

Retrieve the analytics results using the ref_token.

Important Notes

Only call this API after the Pull Status API confirms processing is complete.
The response structure is similar to the Analytics JSON API, containing banking analysis, category-wise breakdowns, and account profiles.

Authentication

This API requires authentication using the following headers:

string

required

Your unique client identifier provided by FinPro during onboarding.

string

required

Your confidential client secret key provided by FinPro. Must be kept secure.

string

required

The unique identifier for your application.

string

required

Your organization’s unique identifier assigned by FinPro.

string

required

Must be set to application/json.

Request Body

string

required

The reference token returned by the Push PDF API. This uniquely identifies the PDF processing job whose results you want to retrieve.

Request Example

{
  "ref_token": "34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"
}

Code Examples

curl --location --request POST '{{Base_URL}}/analytics/pdf/pull/json' \
--header 'client_id: {{Client_Id}}' \
--header 'client_secret: {{Client_Secret}}' \
--header 'organisationId: {{Organisation_Id}}' \
--header 'appIdentifier: {{App_Identifier}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ref_token": "34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"
}'

const response = await fetch('{{Base_URL}}/analytics/pdf/pull/json', {
  method: 'POST',
  headers: {
    'client_id': '{{Client_Id}}',
    'client_secret': '{{Client_Secret}}',
    'organisationId': '{{Organisation_Id}}',
    'appIdentifier': '{{App_Identifier}}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    ref_token: '34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5'
  })
});

const data = await response.json();
console.log(data);

import requests

url = "{{Base_URL}}/analytics/pdf/pull/json"

headers = {
    "client_id": "{{Client_Id}}",
    "client_secret": "{{Client_Secret}}",
    "organisationId": "{{Organisation_Id}}",
    "appIdentifier": "{{App_Identifier}}",
    "Content-Type": "application/json"
}

payload = {
    "ref_token": "34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

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

Body

application/json

Request body containing the reference token for PDF processing status or results.

ref_token

string

required

Reference token returned by the Push PDF API.

Example:

"34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"

Response

Analytics data retrieved successfully

Response containing analytics data for a consent journey.

ver

string

API version that processed the request.

Example:

"1.21.0"

status

string

Overall API call status.

Example:

"success"

data

object

Analytics response payload.

Show child attributes

​Overview

​PDF Analytics Flow

​Important Notes

​Authentication

​Request Body

​Request Example

​Code Examples

Authorizations

Body

Response

Overview

PDF Analytics Flow

Important Notes

Authentication

Request Body

Request Example

Code Examples