SahamatiNet
  • Background
  • SahamatiNet POC
    • Introduction
    • Applications
    • Observability
    • Integration Steps
      • Sandbox Onboarding
      • IAM APIs
      • CR APIs
      • Integration with Router
        • Sample Code Snippets
          • Python
          • Java
          • JavaScript
          • GoLang
          • C#
        • Router APIs Specifications
          • FIU API Specification
          • AA API Specification
          • FIP API Specification
      • ReBIT Workflows using Router
        • Account Discovery & Linking
        • Consent Workflow
        • FI Request Workflow
    • Integration with Simulators
      • AA Simulator
      • FIP Simulator
      • FIU Simulator
    • Validation of Integration
  • Glossary
  • Guidelines
  • Frequently Asked Questions
  • How To Guides
    • How To Onboard to Sandbox ?
    • How To Decide on an Entity ID ?
    • How To Generate a Certificate ?
    • How To Generate Tokens ?
Powered by GitBook
LogoLogo

Copyright © 2025 - Sahamati Foundation

On this page

Was this helpful?

Export as PDF
  1. SahamatiNet POC
  2. Integration Steps

CR APIs

Central Registry APIs

PreviousIAM APIsNextIntegration with Router

Was this helpful?

Fetching Regulated Entities REs metadata using Central Registry (CR)

A RE should fetch the metadata of the other REs to interact with them through ReBIT APIs to handle the AA ecosystem functionalities. Sahamati provided the CR APIs to access the REs metadata. Here is the sequence diagram for Fetching REs metadata.

Fetch REs Metadata using Central Registry

API Collection:

4KB
Central Registry.postman_collection.json
Central Registry - API Collection

Get Entities by Type

get

To fetch the metadata of all the entities of a specific type (FIU or FIP or AA).

Authorizations
Path parameters
typestring · enumRequired

Type of entity

Possible values:
Responses
200
Successful retrieval
application/json
400
Schema validation failure
application/json
401
Unauthorized or Invalid token
404
Entity not found
application/json
get
GET /cr/v2/entityInfo/{type} HTTP/1.1
Host: api.sandbox.sahamati.org.in
Authorization: Bearer JWT
Accept: */*
{
  "ver": "1.0",
  "timestamp": "2024-10-16 08:04:50.314",
  "txnid": "1fbb-11ed-861d-0242",
  "requester": {
    "name": "text",
    "id": "text"
  },
  "entityinfo": {
    "name": "text",
    "id": "text",
    "code": "text",
    "entityhandle": "text",
    "Identifiers": [
      {
        "category": "text",
        "type": "text"
      }
    ],
    "baseurl": "text",
    "webviewurl": "text",
    "fitypes": [
      "text"
    ],
    "certificate": {
      "alg": "text",
      "e": "text",
      "kid": "text",
      "kty": "text",
      "n": "text",
      "use": "text"
    },
    "tokeninfo": {
      "url": "text",
      "desc": "text"
    },
    "inboundports": [
      "text"
    ],
    "outboundports": [
      "text"
    ],
    "ips": [
      "text"
    ]
  }
}

Get Entity by Type and ID

get

To fetch the metadata of a specific entity by its type and ID

Authorizations
Path parameters
typestring · enumRequired

Type of entity

Possible values:
idstringRequired

Entity identifier

Responses
200
Successful retrieval
application/json
400
Schema validation failure
application/json
401
Unauthorized or Invalid token
404
Entity not found
application/json
get
GET /cr/v2/entityInfo/{type}/{id} HTTP/1.1
Host: api.sandbox.sahamati.org.in
Authorization: Bearer JWT
Accept: */*
{
  "ver": "1.0",
  "timestamp": "2024-10-16 08:04:50.314",
  "txnid": "1fbb-11ed-861d-0242",
  "requester": {
    "name": "text",
    "id": "text"
  },
  "entityinfo": {
    "name": "text",
    "id": "text",
    "code": "text",
    "entityhandle": "text",
    "Identifiers": [
      {
        "category": "text",
        "type": "text"
      }
    ],
    "baseurl": "text",
    "webviewurl": "text",
    "fitypes": [
      "text"
    ],
    "certificate": {
      "alg": "text",
      "e": "text",
      "kid": "text",
      "kty": "text",
      "n": "text",
      "use": "text"
    },
    "tokeninfo": {
      "url": "text",
      "desc": "text"
    },
    "inboundports": [
      "text"
    ],
    "outboundports": [
      "text"
    ],
    "ips": [
      "text"
    ]
  }
}
  • Fetching Regulated Entities REs metadata using Central Registry (CR)
  • GETGet Entities by Type
  • GETGet Entity by Type and ID