Docs
Kyb

Search for a company

Search for companies by name or registration number in specified countries.

GET
/v1/kyb/search

Query Parameters

countryCodestring
Value in"UK" | "DE" | "NL" | "FR" | "LU" | "RO" | "PL"
termstring

The search term (company name or registration number)

page?string

page number for pagination (default is 1)

Header Parameters

x-api-keystring

Response Body

curl -X GET "https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string" \
  -H "x-api-key: string"
fetch("https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string", {
  headers: {
    "x-api-key": "string"
  }
})
package main

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

func main() {
  url := "https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string"

  req, _ := http.NewRequest("GET", url, nil)
  req.Header.Add("x-api-key", "string")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string"

response = requests.request("GET", url, headers = {
  "x-api-key": "string"
})

print(response.text)
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.http.HttpResponse.BodyHandlers;
import java.time.Duration;

HttpClient client = HttpClient.newBuilder()
  .connectTimeout(Duration.ofSeconds(10))
  .build();

HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
  .uri(URI.create("https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string"))
  .header("x-api-key", "string")
  .GET()
  .build();

try {
  HttpResponse<String> response = client.send(requestBuilder.build(), BodyHandlers.ofString());
  System.out.println("Status code: " + response.statusCode());
  System.out.println("Response body: " + response.body());
} catch (Exception e) {
  e.printStackTrace();
}
using System;
using System.Net.Http;
using System.Text;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "string");
var response = await client.GetAsync("https://api.ambriel.io/v1/kyb/search?countryCode=UK&term=string&page=string");
var responseBody = await response.Content.ReadAsStringAsync();
{
  "meta": {
    "total": 0,
    "perPage": 0,
    "currentPage": 0,
    "lastPage": 0,
    "firstPage": 0,
    "firstPageUrl": "string",
    "lastPageUrl": "string",
    "nextPageUrl": "string",
    "previousPageUrl": "string"
  },
  "data": [
    {
      "id": null,
      "name": "string",
      "countryCode": "string",
      "companyNumber": "string",
      "taxNumber": "string",
      "legalForm": "string",
      "tradeName": "string",
      "dateFounded": "string",
      "status": "string"
    }
  ]
}
Empty
Empty
Empty
{
  "errors": [
    {
      "message": "The field must be a valid value",
      "rule": "ruleName",
      "field": "phone"
    }
  ]
}
Empty