API docs for old integrations
Company Search by Name V2

Introduction
The Company Search API is a powerful tool that provides a simple and efficient way to retrieve company information based on a keyword search. By leveraging this API, users can easily find the company name and its associated identification number by providing a keyword related to the company they are looking for. Whether you're building a business directory, conducting market research, or verifying company details, this API offers a reliable and streamlined solution.
Key Features:
Keyword-based Search:
 The API enables users to perform searches by specifying a keyword related to the company they want to find. This keyword can be a part of the company name, industry, location, or any other relevant information.
Comprehensive Database:
 The API accesses a comprehensive database of registered companies, ensuring a wide coverage of businesses across various industries and regions. This allows users to retrieve accurate and up-to-date information on a vast number of companies.
Company Name and Identification Number:
 Upon successful search, the API returns the company's full name and its unique identification number. This identification number serves as a reliable reference to identify and distinguish the company from others.
Fast and Efficient:
 The API is designed to provide quick responses, minimizing latency and optimizing the search process. With efficient algorithms and a well-maintained database, users can expect near-instantaneous results for their queries.
Developer-Friendly Integration:
 The API is built with simplicity and ease of integration in mind. It offers a straightforward RESTful interface, allowing developers to seamlessly incorporate company search functionality into their applications, websites, or services.
Secure and Reliable:
 The API follows industry-standard security practices to ensure data privacy and integrity. It uses secure HTTPS connections for all requests, and access can be authenticated using API keys or other authentication mechanisms to protect sensitive information.
In conclusion, the Company Search API offers a reliable and efficient solution for searching and retrieving company information based on a keyword. With its comprehensive database, fast response times, and developer-friendly integration, this API empowers businesses, researchers, and organizations with accurate and up-to-date company data.
﻿
API details
Endpoint
Production environment
POST https://signzy.tech/api/v2/hunts
POST https://signzy.tech/api/v2/hunts
﻿
UAT/Testing environment
POST https://preproduction.signzy.tech/api/v2/hunts
POST https://preproduction.signzy.tech/api/v2/hunts
﻿
﻿
Request headers 
Name
Value
Required
Description
Content-Type
application/json
Mandatory
The type of content that the request body contains.
﻿
Request body parameters
Parameter
Type
Description
Required
target
String
The target of the API request.
Mandatory
itemId
String
Your Patron ID.
Mandatory
accessToken
String
Your access token.
Mandatory
task
String
Specifies the type of task to be performed. It should be "searchCompaniesByName" for this task.
Mandatory
essentials
Object
Contains the essential parameters for the task.
Mandatory
essentials.name
String
Name of the company to search.
Mandatory
essentials.getStatus
String
Indicates whether to return company status or not.
true to return company status else false.
Optional
JSON
{
    "target": "Organization",
    "itemId": "655d908c0929a0012d3c5063",
    "accessToken": "z5npv33p1hekbyrflfg0tagxisohy4qh",
    "task": "searchCompaniesByName",
    "essentials": {
        "name": "Signzy",
        "getStatus": "true"
    }
}
{
    "target": "Organization",
    "itemId": "655d908c0929a0012d3c5063",
    "accessToken": "z5npv33p1hekbyrflfg0tagxisohy4qh",
    "task": "searchCompaniesByName",
    "essentials": {
        "name": "Signzy",
        "getStatus": "true"
    }
}
﻿
﻿
Code samples
Curl
Node.js
Python
Go
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://preproduction.signzy.tech/api/v2/hunts"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "target": "Organization",`+"
"+`
    "itemId": "655d908c0929a0012d3c5063",`+"
"+`
    "accessToken": "z5npv33p1hekbyrflfg0tagxisohy4qh",`+"
"+`
    "task": "searchCompaniesByName",`+"
"+`
    "essentials": {`+"
"+`
        "name": "Signzy",`+"
"+`
        "getStatus": "true"`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("content-type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://preproduction.signzy.tech/api/v2/hunts"
  method := "POST"

  payload := strings.NewReader(`{`+"
"+`
    "target": "Organization",`+"
"+`
    "itemId": "655d908c0929a0012d3c5063",`+"
"+`
    "accessToken": "z5npv33p1hekbyrflfg0tagxisohy4qh",`+"
"+`
    "task": "searchCompaniesByName",`+"
"+`
    "essentials": {`+"
"+`
        "name": "Signzy",`+"
"+`
        "getStatus": "true"`+"
"+`
    }`+"
"+`
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("content-type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}
﻿
﻿
Response body parameters
Parameter
Type
Description
target
String
The target of the API call.
itemId
String
Your Patron ID returned here.
accessToken
String
Your access token.
task
String
The specific task to be performed.
id
String
Unique ID for the API request
essentials
Object
contains the essential parameter for the request.
essentials.name
String
Name of the company to search
essentials.getStatus
String
Indicates whether to return company status or not.
result
Object
Result of the task.
result.message
String
Message describing the result.
result.companiesList
Array of objects
Contains the list of matching company name and their CIN number.
result.companiesList.companyName
String
Company name.
result.companiesList.companyID
String
Company CIN number.
result.companiesList.status
String
Status of the company.
The possible values are:
ACTIVE
UNDER LIQUIDATION
STRIKE OFF
CONVERTED TO LLP
AMALGAMATED
This is returned only when getStatus is true.
JSON
{
    "target": "Organization",
    "itemId": "<Patron ID>",
    "accessToken": "XXXXXXXXXXX",
    "task": "searchCompaniesByName",
    "id": "65794c912a91290125b47c8c",
    "essentials": {
        "name": "Signzy",
        "getStatus": "true"
    },
    "result": {
        "message": "Results found for the combination of inputs.",
        "companiesList": [
            {
                "companyName": "<COMPANY NAME>",
                "companyID": "<CIN>",
                "status": "ACTIVE"
            }
        ]
    }
}
{
    "target": "Organization",
    "itemId": "<Patron ID>",
    "accessToken": "XXXXXXXXXXX",
    "task": "searchCompaniesByName",
    "id": "65794c912a91290125b47c8c",
    "essentials": {
        "name": "Signzy",
        "getStatus": "true"
    },
    "result": {
        "message": "Results found for the combination of inputs.",
        "companiesList": [
            {
                "companyName": "<COMPANY NAME>",
                "companyID": "<CIN>",
                "status": "ACTIVE"
            }
        ]
    }
}
﻿
﻿
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!
Search by GSTIN V2
Voter ID extraction
Docs powered by Archbee
TABLE OF CONTENTS
Request body parameters
Code samples
Response body parameters
Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Parameter	Type	Description	Required
target	String	The target of the API request.	Mandatory
itemId	String	Your Patron ID.	Mandatory
accessToken	String	Your access token.	Mandatory
task	String	Specifies the type of task to be performed. It should be "searchCompaniesByName" for this task.	Mandatory
essentials	Object	Contains the essential parameters for the task.	Mandatory
essentials.name	String	Name of the company to search.	Mandatory
essentials.getStatus	String	Indicates whether to return company status or not. true to return company status else false.	Optional