Name to GSTIN Search

Endpoint Overview

POST /api/v1/corporate/name-to-gstin

Description

The Name to GSTIN Search API enables you to retrieve all GSTINs (Goods and Services Tax Identification Numbers) associated with a given company name. This API is designed to help businesses, financial institutions, and compliance teams quickly map a company’s legal name to its registered GSTINs across India. By automating the GSTIN discovery process, organizations can streamline KYC (Know Your Customer), onboarding, and compliance workflows, reducing manual effort and minimizing errors.

Key Benefits

Instantly fetch all GSTINs linked to a company name for robust due diligence.

Supports bulk and automated KYC/compliance processes.

Reduces manual lookup time and errors.

Enhances onboarding and verification workflows for regulated industries.

Use Cases

Fintech & Banking

B2B Marketplaces

Compliance & Audit

Automate customer onboarding by verifying GSTINs linked to business applicants.

Streamline loan processing and risk assessment by validating business identities.

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token (JWT) for authentication
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
company_name	string	Yes	The full legal name of the company to search GSTINs for.
search_size	int	No	(Optional) Maximum number of GSTINs to return.

Example Request

{
  "company_name": "TechNova Solutions Pvt Ltd",
  "search_size": 10
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Contains the search results and metadata.
data.client_id	string	Unique identifier for the search request.
data.company_name	string	The company name used in the search.
data.search_data	array	List of objects, each containing a GSTIN and the associated company name.
data.search_data[].gstin	string	GSTIN found for the given company name.
data.search_data[].company_name	string	Company name as registered with the GSTIN.
status_code	int	HTTP status code of the response.
success	bool	Indicates if the request was successful.
message	string	Human-readable message about the request status.
message_code	string	Machine-readable status code.

Example Successful Response

{
  "data": {
    "client_id": "gstin_search_AkjslQpwemZnXkOsyuRt",
    "company_name": "TechNova Solutions Pvt Ltd",
    "search_data": [
      {"gstin": "27AAACT1234R1ZL", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "07AAACT1234R2ZK", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "19AAACT1234R3ZM", "company_name": "TechNova Solutions Pvt Ltd"},
      {"gstin": "09AAACT1234R4ZP", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "33AAACT1234R5ZN", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "29AAACT1234R6ZJ", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "32AAACT1234R7ZO", "company_name": "TechNova Solutions Pvt Ltd"},
      {"gstin": "22AAACT1234R8ZR", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "36AAACT1234R9ZL", "company_name": "TECHNOVA SOLUTIONS PVT LTD"},
      {"gstin": "05AAACT1234R1ZS", "company_name": "M/S TECHNOVA SOLUTIONS PVT LTD"}
    ]
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid Token

{
  "status_code": 401,
  "success": false,
  "message": "Invalid or missing authentication token.",
  "message_code": "invalid_token"
}

Authentication failed due to missing or invalid JWT token.

Integration Best Practices

Security Recommendations

Always use HTTPS to protect sensitive data in transit.

Store API keys and JWT tokens securely; never expose them in client-side code or public repositories.

User Experience Guidelines

Validate user input for company names to reduce failed requests.

Display clear error messages to users for missing or invalid data.

Code Samples

cURL

Python

Node.js

Related APIs

GSTIN to Company Name API: Retrieve company details using a GSTIN.

GSTIN Verification API: Validate the authenticity and status of a GSTIN.

PAN to GSTIN API: Find GSTINs linked to a PAN number.

Compliance and Legal Considerations

Ensure you have obtained proper consent from the entity whose GSTINs you are querying. Use this API in accordance with applicable data privacy and regulatory requirements. Misuse of GSTIN data may result in legal consequences.

Note: Always use the correct base URL for your environment:

Sandbox: https://sandbox.surepass.app

Production: https://kyc-api.surepass.app

Replace YOUR_JWT_TOKEN with your actual JWT token.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/name-to-gstin' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "company_name": "TechNova Solutions Pvt Ltd" }'

{ "data": { "client_id": "gstin_search_AkjslQpwemZnXkOsyuRt", "company_name": "TechNova Solutions Pvt Ltd", "search_data": [ { "gstin": "27AAACT1234R1ZL", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "07AAACT1234R2ZK", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "19AAACT1234R3ZM", "company_name": "TechNova Solutions Pvt Ltd" }, { "gstin": "09AAACT1234R4ZP", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "33AAACT1234R5ZN", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "29AAACT1234R6ZJ", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "32AAACT1234R7ZO", "company_name": "TechNova Solutions Pvt Ltd" }, { "gstin": "22AAACT1234R8ZR", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "36AAACT1234R9ZL", "company_name": "TECHNOVA SOLUTIONS PVT LTD" }, { "gstin": "05AAACT1234R1ZS", "company_name": "M/S TECHNOVA SOLUTIONS PVT LTD" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Name To Gstin

Name to GSTIN Search#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses