Central Registry JSON Template

CR Entity Registration

API Parameter Reference · FIP / FIU / AA

This document describes every parameter in the Central Registry entity registration JSON payload. Fields marked Required must be present for all entity types. Fields marked FIP only / AA only apply exclusively to that entity type. Fields marked Ignore are reserved for future use.

Root-Level Parameters

Field / Parameter	Type	Required	Description	Example Value
ver	String	Required	Version of the API/schema being used.	2.0
timestamp	String (ISO 8601)	Required	UTC timestamp of the request in ISO 8601 format.	2026-03-18T08:04:50.314Z
txnid	String (UUID)	Required	Unique transaction ID for tracking this request.	407a70dd-88dd-423d-97a6-edbc0d0694da
type	String (Enum)	Required	Entity type being registered. One of: FIP, FIU, AA.	FIU

requester — Identifies the party submitting the request

Field / Parameter	Type	Required	Description	Example Value
requester.name	String	Required	Display name of the entity submitting the request.	Sahamati FIU Test
requester.id	String	Required	Unique ID of the requesting entity as registered in the CR.	sahamati-fiu-test-new

entityinfo — Core entity registration details

Field / Parameter	Type	Required	Description	Example Value
entityinfo.tags	String	Optional	Environment tag for the entity (e.g. Sandbox, Production).	Sandbox
entityinfo.name	String	Required	Name of the entity as submitted while listing itself in the CR. Note: Ensure this matches exactly as mentioned in your Certificate of Registration (CoR) issued by your regulator.	Sahamati Foundation
entityinfo.id	String	Required	Unique ID issued by the CR to the entity. Note: Please refer to this page for your Entity ID naming convention.	sahamati-fiu-test-new
entityinfo.code	String	Required	ID issued by the financial sector regulator governing this entity. Note: Ensure this matches exactly as mentioned in your Certificate of Registration (CoR) issued by your regulator.
entityinfo.entityhandle	String	AA only	Handle suffix for user profiles managed by the AA (e.g. @aa). Leave blank for FIU/FIP.

entityinfo.Identifiers — Account discovery identifiers

(FIP only; present here for schema completeness)

Field / Parameter	Type	Required	Description	Example Value
Identifiers[].category	String (Enum)	FIP only	Category of identifier accepted for account discovery. Values: STRONG, WEAK, ANCILLARY.	STRONG
Identifiers[].type	String (Enum)	FIP only	Type of identifier (e.g. MOBILE, PAN, DOB). At least one must be STRONG.	MOBILE

entityinfo — Connectivity & Endpoints

Field / Parameter	Type	Required	Description	Example Value
entityinfo.baseurl	String (URL)	Required	URL hosting all ReBIT-compliant API endpoints. Prefix with version e.g. v2: for versioned URLs.	v2:https://data.sahamati.com/fiu/sahamati-test/v2
entityinfo.webviewurl	String (URL)	AA only	URL of the AA web app for FIUs to redirect users to. null for FIU/FIP.	null
entityinfo.fitypes	Array<String>	FIP only	Financial information types from the ReBIT master list that the entity supports. Present here for schema completeness.	DEPOSIT, MUTUAL_FUNDS, EQUITIES...
entityinfo.inboundports	Array<String>	Required	Ports on the entity that counterparties (AA/FIP/FIU) can connect to.	["443"]
entityinfo.outboundports	Array<String>	Required	Ports from which the entity will make outbound requests.	["443"]
entityinfo.ips	Array<String>	Required	IP addresses counterparties may send and receive requests to/from.	["13.127.138.226"]

entityinfo.certificate — Public key in JSON Web Key (JWK) format

Field / Parameter	Type	Required	Description	Example Value
certificate.alg	String	Required	Algorithm used. Typically RS256.	RS256
certificate.kty	String	Required	Key type. Must be RSA.	RSA
certificate.use	String	Required	Intended use of the key. sig = signature verification.	sig
certificate.kid	String	Required	Key ID — unique identifier for this key.	ed9c4269-96de-4a62-b057-e2dd628d359c
certificate.e	String	Required	RSA public exponent (Base64url encoded).	AQAB
certificate.n	String	Required	RSA modulus — the public key value (Base64url encoded).	ngB4ScutfK6776QK...

entityinfo.gsp — Gateway Service Provider

(Leave these Field/Parameter values as null — Reserved for future use)

Field / Parameter	Type	Required	Description	Example Value
gsp	null	null	GSP details when a gateway sits between AAs and the FIP (e.g. GSTN). Set to null for FIU/AA.	null

entityinfo.tokeninfo — Token issuance details

(Leave these Field/Parameter values as empty — Reserved for future use)

Field / Parameter	Type	Required	Description	Example Value
tokeninfo.url	String (URL)	Keep Empty	URL of the entity's Token Issuance Service. Reserved for future use.	""
tokeninfo.desc	String	Keep Empty	Description field. Reserved for future use.	""

entityinfo.signature — Request signature

(Leave these Field/Parameter values as empty — Reserved for future use)

Field / Parameter	Type	Required	Description	Example Value
signature.signValue	String	Keep Empty	Cryptographic signature of the request payload. Reserved for future use.	""

---

Notes

• baseurl will be prefixed with a version tag (e.g. v2:https://...) to indicate the supported API version.

• certificate fields follow the JSON Web Key (RFC 7517) specification.

• tokeninfo and signature fields are present in the schema but should be left empty / ignored until further notice.

• gsp must be set to null for FIU and AA entity types.

• entityhandle and webviewurl are AA-specific and should be omitted or set to null/blank for FIP and FIU.

Template

Note: The base JSON structure is identical for all RE types. The tabs below are provided for clarity — each view highlights the relevant fields and example values as applicable to that entity type (FIU, FIP, or AA).

FIU

{
  "ver": "1.0",
  "timestamp": "2026-03-18T08:04:50.314Z",
  "txnid": "407a70dd-88dd-423d-97a6-edbc0d0694da",
  "type": "FIU",
  "requester": {
    "name": "Sahamati FIU Test",
    "id": "sahamati-fiu-test-new"
  },
  "entityinfo": {
    "tags": "Sandbox",
    "name": "Sahamati FIU Test",
    "id": "sahamati-fiu-test-new",
    "code": "sahamati-fiu-test-new",
    "entityhandle": "",
    "Identifiers": [],
    "baseurl": "v2:https://data.sahamati.com/fiu/sahamati-test/v2",
    "webviewurl": null,
    "fitypes": [],
    "certificate": {
      "e": "AQAB",
      "n": "<RSA modulus here>",
      "alg": "RS256",
      "kid": "<key-id-uuid>",
      "kty": "RSA",
      "use": "sig"
    },
    "tokeninfo": {
      "url": "",
      "desc": ""
    },
    "gsp": null,
    "signature": {
      "signValue": ""
    },
    "inboundports": ["443"],
    "outboundports": ["443"],
    "ips": ["<ip-address>"]
  }
}

FIP

{
  "ver": "1.0",
  "timestamp": "2026-03-18T08:04:50.314Z",
  "txnid": "407a70dd-88dd-423d-97a6-edbc0d0694da",
  "type": "FIP",
  "requester": {
    "name": "Sahamati FIP Test",
    "id": "sahamati-fip-test"
  },
  "entityinfo": {
    "tags": "Sandbox",
    "name": "Sahamati FIP Test",
    "id": "sahamati-fip-test",
    "code": "sahamati-fip-test",
    "entityhandle": "",
    "Identifiers": [
      { "category": "STRONG", "type": "MOBILE" },
      { "category": "STRONG", "type": "PAN" }
    ],
    "baseurl": "v2:https://data.sahamati.com/fip/sahamati-test/v2",
    "webviewurl": null,
    "fitypes": [
      "DEPOSIT", "TERM_DEPOSIT", "RECURRING_DEPOSIT", "SIP", "CP",
      "EQUITIES", "MUTUAL_FUNDS"
    ],
    "certificate": {
      "e": "AQAB",
      "n": "<RSA modulus here>",
      "alg": "RS256",
      "kid": "<key-id-uuid>",
      "kty": "RSA",
      "use": "sig"
    },
    "tokeninfo": {
      "url": "",
      "desc": ""
    },
    "gsp": null,
    "signature": {
      "signValue": ""
    },
    "inboundports": ["443"],
    "outboundports": ["443"],
    "ips": ["<ip-address>"]
  }
}

AA

{
  "ver": "1.0",
  "timestamp": "2026-03-18T08:04:50.314Z",
  "txnid": "407a70dd-88dd-423d-97a6-edbc0d0694da",
  "type": "AA",
  "requester": {
    "name": "Sahamati AA Test",
    "id": "sahamati-aa-test"
  },
  "entityinfo": {
    "tags": "Sandbox",
    "name": "Sahamati AA Test",
    "id": "sahamati-aa-test",
    "code": "sahamati-aa-test",
    "entityhandle": "@sahamati-aa-test",
    "Identifiers": [],
    "baseurl": "v2:https://data.sahamati.com/aa/sahamati-test/v2",
    "webviewurl": "https://webview.sahamati.com/aa/sahamati-test",
    "fitypes": [],
    "certificate": {
      "e": "AQAB",
      "n": "<RSA modulus here>",
      "alg": "RS256",
      "kid": "<key-id-uuid>",
      "kty": "RSA",
      "use": "sig"
    },
    "tokeninfo": {
      "url": "",
      "desc": ""
    },
    "gsp": null,
    "signature": {
      "signValue": ""
    },
    "inboundports": ["443"],
    "outboundports": ["443"],
    "ips": ["<ip-address>"]
  }
}