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

POST https://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

{
    "target": "Organization",
    "itemId": "655d908c0929a0012d3c5063",
    "accessToken": "z5npv33p1hekbyrflfg0tagxisohy4qh",
    "task": "searchCompaniesByName",
    "essentials": {
        "name": "Signzy",
        "getStatus": "true"
    }
}

Code samples

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.

{
    "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!