---
agentTools:
  projectIndex: https://docs.decentro.tech/llms.txt
---

# GSTIN to CIN

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Decentro Staging",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://in.staging.decentro.tech"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v2/bytes/converter/gstin/cin": {
      "post": {
        "summary": "GSTIN to CIN",
        "description": "",
        "operationId": "gstin-to-cin",
        "parameters": [
          {
            "name": "client_id",
            "in": "header",
            "description": "A unique identifier assigned to your application when registering with an API or authorization server.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "client_secret",
            "in": "header",
            "description": "A confidential key used by your application to authenticate itself securely with the API server.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "reference_id",
                  "consent",
                  "purpose"
                ],
                "properties": {
                  "reference_id": {
                    "type": "string",
                    "description": "Any unique ID assigned by you for this API request.",
                    "default": "ABC123"
                  },
                  "consent": {
                    "type": "boolean",
                    "description": "true/false based on the consent given by the customer. Mandatory as per regulation",
                    "default": true
                  },
                  "purpose": {
                    "type": "string",
                    "description": "The purpose of taking this consent from your customer. Mandatory as per regulation. (>20 characters)",
                    "default": "To retrieve RC details"
                  },
                  "id": {
                    "type": "string",
                    "description": "The Chassis Number of the vehicle."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Success": {
                    "value": "{\n    \"decentroTxnId\": \"395266F6EF5942C3AEE9BEECFF9A559C\",\n    \"status\": \"SUCCESS\",\n    \"responseCode\": \"S00000\",\n    \"message\": \"CIN retrieved successfully\",\n    \"data\": [\n        {\n            \"company\": \"EXAMPLE HEALTH SOLUTIONS PRIVATE LIMITED\",\n            \"cin\": \"A11111AA1111AAA0111111\",\n            \"stringMatch\": 100,\n            \"phoneticMatch\": 100\n        },\n        {\n            \"company\": \"HEALTH INNOVATION SOLUTIONS LLP\",\n            \"cin\": \"AAA-1111\",\n            \"stringMatch\": 65,\n            \"phoneticMatch\": 60\n        },\n        {\n            \"company\": \"AB HEALTH SOLUTIONS PRIVATE LIMITED\",\n            \"cin\": \"B11111AA1111AAA011111\",\n            \"stringMatch\": 85,\n            \"phoneticMatch\": 81\n        }\n    ],\n    \"responseKey\": \"success_cin_search_by_gstin\"\n}"
                  },
                  "Success- No record found": {
                    "value": "{\n  \"decentroTxnId\": \"2C5F44978CC245A185A0FE115353EB06\",\n  \"status\": \"SUCCESS\",\n  \"responseKey\": \"error_no_record_found\",\n  \"responseCode\": \"S00000\",\n  \"message\": \"No CIN record found\",\n  \"data\": null\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Success",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "395266F6EF5942C3AEE9BEECFF9A559C"
                        },
                        "status": {
                          "type": "string",
                          "example": "SUCCESS"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "S00000"
                        },
                        "message": {
                          "type": "string",
                          "example": "CIN retrieved successfully"
                        },
                        "data": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "company": {
                                "type": "string",
                                "example": "EXAMPLE HEALTH SOLUTIONS PRIVATE LIMITED"
                              },
                              "cin": {
                                "type": "string",
                                "example": "A11111AA1111AAA0111111"
                              },
                              "stringMatch": {
                                "type": "integer",
                                "example": 100,
                                "default": 0
                              },
                              "phoneticMatch": {
                                "type": "integer",
                                "example": 100,
                                "default": 0
                              }
                            }
                          }
                        },
                        "responseKey": {
                          "type": "string",
                          "example": "success_cin_search_by_gstin"
                        }
                      }
                    },
                    {
                      "title": "Success- No record found",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "2C5F44978CC245A185A0FE115353EB06"
                        },
                        "status": {
                          "type": "string",
                          "example": "SUCCESS"
                        },
                        "responseKey": {
                          "type": "string",
                          "example": "error_no_record_found"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "S00000"
                        },
                        "message": {
                          "type": "string",
                          "example": "No CIN record found"
                        },
                        "data": {}
                      }
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Invalid Input": {
                    "value": "{\n    \"decentroTxnId\": \"55B144E127614D49B14474ECAFF39E9D\",\n    \"status\": \"FAILURE\",\n    \"responseCode\": \"E00009\",\n    \"message\": \"Invalid GSTIN. GSTIN should be of 15 characters where the first two characters are numerals between 01 to 35 indicating state code, next 10 characters are combination of five letters, four numerals and a letter indicating PAN and the last three characters are a numeral, a letter and a numeral respectively.\",\n    \"responseKey\": \"error_invalid_gstin\"\n}"
                  },
                  "Error- Duplicate Reference Id": {
                    "value": "{\n    \"decentroTxnId\": \"A8E9EFCFEE5C4929B1A2993D61086722\",\n    \"status\": \"FAILURE\",\n    \"responseCode\": \"E00019\",\n    \"message\": \"Duplicate Request Reference ID\",\n    \"responseKey\": \"error_duplicate_reference_id\"\n}"
                  }
                },
                "schema": {
                  "oneOf": [
                    {
                      "title": "Invalid Input",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "55B144E127614D49B14474ECAFF39E9D"
                        },
                        "status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "E00009"
                        },
                        "message": {
                          "type": "string",
                          "example": "Invalid GSTIN. GSTIN should be of 15 characters where the first two characters are numerals between 01 to 35 indicating state code, next 10 characters are combination of five letters, four numerals and a letter indicating PAN and the last three characters are a numeral, a letter and a numeral respectively."
                        },
                        "responseKey": {
                          "type": "string",
                          "example": "error_invalid_gstin"
                        }
                      }
                    },
                    {
                      "title": "Error- Duplicate Reference Id",
                      "type": "object",
                      "properties": {
                        "decentroTxnId": {
                          "type": "string",
                          "example": "A8E9EFCFEE5C4929B1A2993D61086722"
                        },
                        "status": {
                          "type": "string",
                          "example": "FAILURE"
                        },
                        "responseCode": {
                          "type": "string",
                          "example": "E00019"
                        },
                        "message": {
                          "type": "string",
                          "example": "Duplicate Request Reference ID"
                        },
                        "responseKey": {
                          "type": "string",
                          "example": "error_duplicate_reference_id"
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "627cbd56949a61004bbb9c80:69ef2066f317eabae2cbe9be"
}
```