Create Organization Object

API Description

The provided API allows you to create organizations for a specific patron. By making a POST request to the specified endpoint, you can create organizations associated with a particular patron ID. The access token provided in response of this API can be used further to call the other ROC APIs.

API Details

Endpoint

POST https://signzy.tech/api/v2/patrons/<patron-id>/organizations

POST https://preproduction.signzy.tech/api/v2/patrons/<patron-id>/organizations

Request body parameters

Parameter	Data Type	Description	Required
identifier	String	The CIN (Corporate Identification Number)/ DIN of the company.	Optional
service	String	Specifies the service as "roc" (Registrar of Companies) in our case.	Optional
callbackUrl	String	The URL to which the response will be sent.	Mandatory

{
    "identifier": "<CIN/DIN number>",
    "service": "roc",
    "callbackUrl": "https://<callback_url>.com"
}

Request headers

Name	Value	Required	Description
Content-Type	application/JSON	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.

Code samples

curl --location 'https://signzy.tech/api/v2/patrons/<patron-id>/organizations' \
--header 'Authorization: <Token>' \
--header 'Content-Type: application/json' \
--data '{
    "identifier": "U74900MH2011PTC216800",
    "service": "roc",
    "callbackUrl": "https://<callback_url>.com"
}'

Response body parameters

Parameter	Data Type	Description
callbackUrl	String	The URL to which the response will be sent.
accessToken	String	The access token for the created organization object, will be used in further ROC APIs.
id	String
patronId	String	The patron ID associated with the organization object.
identifier	String	The CIN (Corporate Identification Number)/DIN of the company.
service	String	The service associated with the organization. The value would be "roc" in our case.

{
    "callbackUrl": "https://<callback_url>.com",
    "accessToken": "<token_to_be_used_in_following_requests>",
    "id": "659d1b405e1e240027c02390",
    "patronId": "<patron-id>",
    "identifier": "U74900MH2011PTC216800",
    "service": "roc"
}

Contact Us for Any Assistance

If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!