Create a Refresh report

BankAnalyze allows you to keep a borrower’s connection to an institution active and pull the latest available data from the connection at any time into a new report. In order to retain the record of historical reports, the latest data is pulled into a new report with a new report ID and the original report is left unchanged.

Note that the API will return an error if you attempt to create a Refresh report for a report_id where sign-in process is incomplete. In this case, there is no active connection from which to pull data. This will return a 400 response with a status_code of “NO_PLATFORM_USER”.

1. Refresh Request

URL: POST /create_and_send_customer_url

Name	Type	Required	Allowed Values	Length	Description
request_id	String	Yes		64	Unique ID for API request. Can be any unique ID generated by you.
customer_id	String	Yes		64	Unique ID for the borrower in external system.
report_id	String	Yes		6	Source report_id for existing report. Connection from source report will be used to create new report.
report_type	String	No	Refresh	128	Default value: Signup. What type of new report to create. Signup: Borrower signs into their bank account. Reauth - Cancel all open reports and create a new Signup report. Refresh - Pull latest data for an existing connection

2. Reauth Response

Name	Type	Required	Allowed Values	Length	Description
status_code	String	Yes		32	Status code for the request
message	String	Yes		300	Message with report id

3. Example JSON Request

Request Header:

{  "x-api-key": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",  "Content-Type": "application/json"}

Payload:

{  "request_id": "REQ-25",  "customer_id": "8",  "report_id": "6CAANY",  "report_type": "Refresh"}

4. Example JSON Response

{  "status_code": "BACKEND_PULL_STARTED",  "message": "New report  #0S3SI0 created using #DLE2J3"}