Home
📖 AcuCheck API Guide
This guide provides comprehensive details about AcuCheck APIs and related information, which is helpful to enable integration with financial institutions and lending platforms, offering features for bank account analysis, DTI (Debt-to-Income) calculations, customer onboarding, and financial risk assessment. The AcuCheck is a financial services platform by AcuFi that helps instant bank analysis, customer financial scoring, and advanced reporting capabilities.
Common Error Codes

📖 AcuCheck API Guide
This guide provides comprehensive details about AcuCheck APIs and related information, which is helpful to enable integration with financial institutions and lending platforms, offering features for bank account analysis, DTI (Debt-to-Income) calculations, customer onboarding, and financial risk assessment. The AcuCheck is a financial services platform by AcuFi that helps instant bank analysis, customer financial scoring, and advanced reporting capabilities.
- Quickstart on AcuCheck API
- AcuCheck API Endpoints and Webhooks
  The AcuCheck API is divided into several main categories of endpoints. Authentication endpoints are used to manage user sessions via login, logout, and identity verification. Bank Account Verification endpoints validate financial account information to prevent fraud and ensure correctness. Customer Management endpoints are used for creating and managing customer profiles. Instant Bank Analysis endpoints handle requests related to financial data and report generation.
- AcuCheck API Access
  Access to the AcuCheck API is secured through session-based authentication.
- AcuCheck API Protocols and Headers
  All interactions with the AcuCheck API are conducted over HTTPS, and only secure TLS connections are supported.
- AcuCheck API Host
- AcuCheck API Status and Incidents
  The AcuCheck API is designed for reliability and high availability.
- Storing AcuCheck API Data
- AcuCheck API Field Formats
- AcuCheck OpenAPI Defenition File
- Postman Collection
- Common Error Codes
- Integration Best Practices

Common Error Codes

Note:

Please contact AcuCheck Support if you require more information on specific error codes.

This error response schema ensures that developers can easily identify the cause of failure and take appropriate action to resolve the issue, whether it be related to authentication, data validation, permissions, or server-side issues. When an error occurs in the AcuCheck API, the response will follow the format outlined below:

Error Response Schema

{
  "success": false,
  "message": "Operation failed",
  "data": null,
  "errors": [
    "Specific error message 1",
    "Specific error message 2"
  ]
}

Common Errors

Table 1. Common errors and resolution table
HTTP Code	Error Code	Message	Resolution
400	`INVALID_REQUEST`	Invalid request data or parameters	Check the request payload, query parameters, or headers. Ensure required fields are provided in the correct format.
401	`UNAUTHORIZED`	Authentication required or invalid credentials	Verify authentication method (API key, token, certificate). Re-authenticate or refresh expired tokens.
403	`FORBIDDEN`	Insufficient permissions	Ensure the user/API key has proper roles/permissions. Contact admin if additional access is required.
404	`NOT_FOUND`	Requested resource not found	Check the endpoint URL, resource ID, or path. Ensure the resource exists and is accessible.
500	`INTERNAL_ERROR`	Server-side error occurred	Retry after some time. If persistent, contact support with error details and request ID.