Search for a company

Before creating an Entity, you can perform a lookup search to fill more details for a more accurate check

Company Search

POST /api-company-search

Perform a registry search if you only have either a Company's Name or Registration Number, to retrieve the missing information and/or confirm the details match what is present on the relevant registry.

Name	Value
Content-Type	multipart/form-data
Authorization	Bearer YOUR_TOKEN

Body

Name	Type	Description
companyName	string	The entity's legal name
registrationNumber	string	The entity's registration, or company number. e.g ACN/ABN for AUS
countryISO	string	The entity's countryISO of incorporation. (ISO-3166 3 char) (required).

Request

cURL

curl --location 'https://enterprise.personr.co/api/1.1/wf/api-company-search' \
--form 'companyName="Acme Pty Ltd"' \
--form 'registrationNumber="123456789"' \
--form 'countryISO="AUS"' \

Node.js

var axios = require('axios');
var FormData = require('form-data');
var data = new FormData();
data.append('companyName', 'Acme Pty Ltd');
data.append('registrationNumber', '123456789');
data.append('country', 'AUS');

var config = {
  method: 'post',
maxBodyLength: Infinity,
  url: 'https://enterprise.personr.co/api/1.1/wf/api-company-search',
  headers: { 
    ...data.getHeaders()
  },
  data : data
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Javascript

var form = new FormData();
form.append("companyName", "Acme Pty Ltd");
form.append("registrationNumber", "123456789");
form.append("country", "AUS");

var settings = {
  "url": "https://enterprise.personr.co/api/1.1/wf/api-company-search",
  "method": "POST",
  "timeout": 0,
  "processData": false,
  "mimeType": "multipart/form-data",
  "contentType": false,
  "data": form
};

$.ajax(settings).done(function (response) {
  console.log(response);
});

Ruby

require "uri"
require "net/http"

url = URI("https://enterprise.personr.co/api/1.1/wf/api-company-search")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
form_data = [['companyName', 'Acme Pty Ltd'],['registrationNumber', '123456789'],['country', 'AUS']]
request.set_form form_data, 'multipart/form-data'
response = https.request(request)
puts response.read_body

Python

import requests

url = "https://enterprise.personr.co/api/1.1/wf/api-company-search"

payload={'companyName': 'Acme Pty Ltd',
'registrationNumber': '123456789',
'country': 'AUS'
}

files=[

]
headers = {}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

Response

200

example for AUS companies:

{
    "results": [
        {
            "abn": "123456789",
            "acn": "123456789",
            "registeredName": "Acme Pty Ltd",
            "status": "Registered",
            "location": "VIC 3000",
            "entityType": "Australian Private Company",
            "tradingNames": [
                "ACME PTY LTD",
                "ACME MANUFACTURING PTY LTD"
            ]
        }
     ]
}



example for non-AUS companies:

{
    "results": [
        {
            "name": "ACME",
            "registrationCode": "123456789",
            "countryCode": "FR"
        }
   ]
}