Router Integration Helper API

Generate Request Header

post

This API generates request headers required to call Router.

Body

application/json

rebitAPIEndpointstringRequiredExample: /accounts/discover

recipientIdstringRequiredExample: FIP-SIMULATOR

customerIdstringRequiredExample: 6363534224@aa_simulator

additionalAttributesobjectOptional

Responses

200

Successfully generated request header

application/json

401

Unauthorized – invalid or missing Bearer token

application/json

404

Bad request – invalid payload

application/json

post

/request/header

HTTPcURLJavaScriptPython

POST /router-helper/v1/request/header HTTP/1.1
Host: api.sandbox.sahamati.org.in
Content-Type: application/json
Accept: */*
Content-Length: 405

{
  "rebitAPIEndpoint": "/accounts/discover",
  "recipientId": "FIP-SIMULATOR",
  "customerId": "6363534224@aa_simulator",
  "additionalAttributes": {},
  "requestBody": {
    "ver": "2.0.0",
    "timestamp": "2023-06-26T06:41:54.904+0000",
    "txnid": "f35761ac-4a18-11e8-96ff-0277a9fbfedcs",
    "Customer": {
      "id": "6363534224@aa_simulator",
      "Identifiers": [
        {
          "category": "STRONG",
          "type": "AADHAAR",
          "value": "XXXXXXXXXXXXXXXX"
        }
      ]
    },
    "FITypes": [
      "DEPOSIT"
    ]
  }
}

{
  "timestamp": "2025-09-10T09:42:43.584Z",
  "x-request-meta": "eyJjdXN0LWlkIjoiYTE3NDFhYjkzZWI2YzVmMTI1OWY4NGZkMjU2OTA3NmJhMzdiZGFmODQxMDc2MzE4ZWZiYzE3ODExZmRmMjE5OCIsInJlY2lwaWVudC1pZCI6IkZJUC1TSU1VTEFUT1IiLCJ0eG4taWQiOiJmMzU3NjFhYy00YTE4LTExZTgtOTZmZi0wMjc3YTlmYmZlZGNzIiwidHJhY2UtaWQiOiJhMTc0MWFiOTNlYjZjNWYxMjU5Zjg0ZmQyNTY5MDc2YmEzN2JkYWY4NDEwNzYzMThlZmJjMTc4MTFmZGYyMTk4In0=",
  "host": "https://api.sandbox.sahamati.org.in/router/v2"
}

Generate Response Header

post

This API generates response headers that can be used while sending data back to Router APIs.

Body

application/json

rebitAPIEndpointstringRequiredExample: /accounts/discover

recipientIdstringRequiredExample: AA-SIMULATOR

additionalAttributesobjectOptional

Responses

200

Successfully generated response header

application/json

401

Unauthorized – invalid or missing Bearer token

application/json

404

Bad request – invalid payload

application/json

post

/response/header

HTTPcURLJavaScriptPython

POST /router-helper/v1/response/header HTTP/1.1
Host: api.sandbox.sahamati.org.in
Content-Type: application/json
Accept: */*
Content-Length: 344

{
  "rebitAPIEndpoint": "/accounts/discover",
  "recipientId": "AA-SIMULATOR",
  "additionalAttributes": {},
  "responseBody": {
    "ver": "2.0.0",
    "timestamp": "2023-06-26T06:45:54.904+0000",
    "txnid": "f35761ac-4a18-11e8-96ff-0277a9fbfedcs",
    "DiscoveredAccounts": [
      {
        "FIType": "DEPOSIT",
        "accType": "SAVINGS",
        "accRefNumber": "BANK11111111",
        "maskedAccNumber": "XXXXXXX3468"
      }
    ]
  }
}

{
  "timestamp": "2025-09-10T09:42:43.584Z",
  "x-response-meta": "eyJhY2MtZGlzY292ZXJlZC1jb3VudCI6IjEiLCJyZWNpcGllbnQtaWQiOiJGSVAtU0lNVUxBVE9SIiwidHhuLWlkIjoiZjM1NzYxYWMtNGExOC0xMWU4LTk2ZmYtMDI3N2E5ZmJmZWRjcyJ9",
  "host": "https://api.sandbox.sahamati.org.in/router/v2"
}