Quick Search by DIN

4 min

Introduction

This document provides detailed information on how to use the API endpoint for creating new organizations associated with a particular patron. The endpoint allows for the creation of new organizations by providing necessary information such as the patron ID, company CIN, and callback URL.

Sample Curl

curl --request POST \
  --url https://signzy.tech/api/v2/patrons/...patronid..../organizations \
  --header 'Accept: */*' \
  --header 'Accept-Language: en-US,en;q=0.8' \
  --header 'Authorization: <Access-Token>' \
  --header 'content-type: application/json' \
  --data '{"identifier":"...companycin...","service":"roc","callbackUrl":"...call URL..."}'

Parameter	Data Type	Required	Description
identifier	string	Yes	The unique identifier of the company (company CIN)
service	string	Yes	The service being requested (ROC)
callbackUrl	string	Yes	The URL where the response will be sent after completion
Authorization	string	Yes	Access token for the API

Sample Response

     {
        "callbackUrl": "...callback...",
        "accessToken": "...accestoken....",
        "id": "....id...",
        "patronId": "....patronid...",
        "identifier": "...identifier...",
        "service": "roc"
    }

Parameter	Data Type	Required	Description
callbackUrl	string	Yes	The URL to which the response will be sent once the request is processed
accessToken	string	Yes	The access token required to access the organization
id	string	Yes	The unique identifier assigned to the organization
patronId	string	Yes	The unique identifier assigned to the patron requesting the organization
identifier	string	Yes	The identifier assigned to the organization (e.g., company CIN)
service	string	Yes	The service requested for the organization (e.g., ROC)