Start bank statement consent

POST

https://api-dev.myemipay.com/application/income/consent

Last modified:2026-09-25 07:30:30

Start bank statement consent

Description: starts an Account Aggregator bank link. The customer approves read-only statement access in their AA app. We never see the bank password.

Usage: when the app wants salary from statements. Optional relative to the main journey — it does not block PAN or Aadhaar.

Details: needs the verified login mobile. Body may set redirectUrl (default myemi://aa/callback). 201 is { status: "requested", url }. Open url. A mock url contains mock-fineye.local and the next status poll is already completed.

Next: GET /application/income/status until status is completed, rejected, revoked, or expired.

Auth: Authorization: Bearer {{accessToken}}

Errors: 401 unauthorized | session_expired · 422 validation_failed — no verified mobile

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Examples

Responses

🟢201Consent link

application/json

Bodyapplication/json

🟠401Unauthorized

🟠422A verified mobile number is required before connecting a bank

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.myemipay.com/application/income/consent' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "redirectUrl": "https://trulens.in"
}'

Response Example

201 - Consent link

{
  "status": "requested",
  "url": "https://aa.example/consent/handle"
}

Modified at 2026-09-25 07:30:30

HTML origination document pack

Poll bank statement consent