Search Legal Entities

curl --request GET \
  --url https://api.bizzy.ai/v2/search/legal-entities \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v2/search/legal-entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v2/search/legal-entities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.bizzy.ai/v2/search/legal-entities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v2/search/legal-entities")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "data": [
        {
            "legalEntityId": "1778186251",
            "countryCode": "BE",
            "name": "Bizzy AI",
            "isPrimary": true
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 1
    }
}

GET

legal-entities

Search Legal Entities

curl --request GET \
  --url https://api.bizzy.ai/v2/search/legal-entities \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.bizzy.ai/v2/search/legal-entities', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.bizzy.ai/v2/search/legal-entities",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.bizzy.ai/v2/search/legal-entities"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.bizzy.ai/v2/search/legal-entities")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
    "data": [
        {
            "legalEntityId": "1778186251",
            "countryCode": "BE",
            "name": "Bizzy AI",
            "isPrimary": true
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 1
    }
}

Request

Provide exactly one of q (name search) or vat (VAT-number search). Supplying neither or both returns a 400. An empty value counts as absent, so ?q=&vat=BE0400378485 is treated as a VAT search. Search is free — it does not spend credits.

Query

string

The name of the legal entity you want to query, up to 20 characters. Mutually exclusive with vat.

string

The VAT number of the legal entity you want to query, up to 30 characters. Mutually exclusive with q. Accepts either a formatted (0400.378.485) or bare (BE0400378485) value — it is normalized across all supported registry/VAT formats before matching.

string

Any supported country code — see Supported countries. If omitted, the search runs across all supported countries.

number

default:"4"

Number of items to return per page. (max 500)

number

default:"0"

Number of items to skip. (max 9500)

{
    "data": [
        {
            "legalEntityId": "1778186251",
            "countryCode": "BE",
            "name": "Bizzy AI",
            "isPrimary": true
        }
    ],
    "pagination": {
        "limit": 4,
        "offset": 0,
        "total": 1
    }
}

Getting Started

V2 API

V1 API

Search Legal Entities

Request

Query

​Request

​Query

Request

Query