FinEye Financial Analysis Suite
  1. Statement Analysis Product APIs
FinEye Financial Analysis Suite
  • Statement Analysis Product APIs
    • Generate Session ID
      POST
    • Upload
      POST
    • Pre Analysis
      POST
    • Data Parsing
      POST
    • Pre Analysis with Data Parsing
      POST
    • Start Analysis
      POST
    • Check Status
      POST
    • Retrieve Report
      GET
  1. Statement Analysis Product APIs

Generate Session ID

POST
https://analysis.fineye.co/generateSessionId
Generate a processing session for a specific borrower and document type. The session ID returned is used to track and manage all subsequent API operations within the workflow. This unique session acts as a reference for document upload, analysis, status checks, and report retrieval.

Response Codes#

Status CodesBillableMessage
OKRESNoSuccess
PARMSNoParameter missing
Consent missing or invalid
ISERRNoInternal server error
AUTHMNoAuthkey missing or invalid
NOPRVNoYour account does not have the required privilege to access this API
RLEXXNoRequest limit exceeded
IPNTWNoIP address not whitelisted
INDIDNoInvalid document ID
INBIDNoInvalid borrower ID

Request

Authorization
Add parameter in header
authKey
Example:
authKey: ********************
Header Params

Body Params application/json

Examples

Responses

🟢200generateSessionId
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://analysis.fineye.co/generateSessionId' \
--header 'authKey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "borrowerId": "BR-9773777601",
    "documentId": "01",
    "consent": "Y",
    "consent_text": "We confirm that we have obtained the consent of the respective customer to fetch their details by using their Bank Statements and the customer is aware of the purpose for which their data is sought for being processed and have given their consent for the same and such consent is currently valid and not withdrawn."
}'
Response Response Example
{
    "api_category": "Financial Analysis Suite",
    "api_name": "FinEye - Generate Session ID",
    "datetime": "2026-01-22 12:23:29.372686",
    "message": "Success",
    "result": {
        "expired_at": "2026-01-22 13:23:29.365756",
        "session_id": "referenceID_wyNwZAfpAEpPlqMSCenk"
    },
    "status": "OKRES",
    "txn_id": "919837da-860c-43e7-a21f-4d4a6c083923"
}
Modified at 2026-01-22 12:44:55
Previous
Statement Analysis Product APIs
Next
Upload
Built with