Error
A valid request URL is required to generate request examples{
"status": "success",
"data": {
"status": "COMPLETED",
"message": "Processing complete. Use Pull Analytics JSON to retrieve results."
}
}{
"ver": "1.21.0",
"timestamp": "2025-10-01T11:49:28.920Z",
"errorCode": "InvalidRequest",
"errorMsg": "Invalid ref_token",
"status": "FP0001"
}{
"ver": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"errorCode": "<string>",
"errorMsg": "<string>",
"status": "<string>"
}PDF Analytics API
Pull Status
Check the processing status of a previously pushed PDF. Step 2 of the PDF Analytics flow.
POST
/
analytics
/
pdf
/
pull
/
status
Error
A valid request URL is required to generate request examples{
"status": "success",
"data": {
"status": "COMPLETED",
"message": "Processing complete. Use Pull Analytics JSON to retrieve results."
}
}{
"ver": "1.21.0",
"timestamp": "2025-10-01T11:49:28.920Z",
"errorCode": "InvalidRequest",
"errorMsg": "Invalid ref_token",
"status": "FP0001"
}{
"ver": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"errorCode": "<string>",
"errorMsg": "<string>",
"status": "<string>"
}Overview
The Pull Status API is the second step in the PDF Analytics flow. After uploading bank statement PDFs via the Push PDF API, use this endpoint to check whether the analytics processing is complete.PDF Analytics Flow
1
Push PDF
Upload bank statement PDFs using the Push PDF API. Receive a
ref_token.2
Check Status (this API)
Poll this API using the
ref_token to check if processing is complete.3
Pull Analytics JSON
Once status is complete, retrieve results using the Pull Analytics JSON API.
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.
Request Example
{
"ref_token": "34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"
}
Code Examples
curl --location --request POST '{{Base_URL}}/analytics/pdf/pull/status' \
--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/status', {
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/status"
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
Your unique client identifier provided by MoneyOne during FIU onboarding
Your confidential client secret provided by MoneyOne
Your organization's unique identifier in the FinPro system
Application-specific identifier for tracking API calls
Body
application/json
Request body containing the reference token for PDF processing status or results.
Reference token returned by the Push PDF API.
Example:
"34b11d14-1bee-4966-bcdc-c2c7ce9ff9a5"
Was this page helpful?