Kyb
Get company by VAT number
Retrieve detailed information about a specific company using its country code and registration number.
curl -X GET "https://api.ambriel.io/v1/kyb/company/:countryCode/vat/:value" \
-H "x-api-key: string"fetch("https://api.ambriel.io/v1/kyb/company/:countryCode/vat/:value", {
headers: {
"x-api-key": "string"
}
})package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.ambriel.io/v1/kyb/company/:countryCode/vat/:value"
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/company/:countryCode/vat/:value"
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/company/:countryCode/vat/:value"))
.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/company/:countryCode/vat/:value");
var responseBody = await response.Content.ReadAsStringAsync();{
"name": "string",
"tradeName": "string",
"taxNumber": "string",
"companyNumber": "string",
"countryCode": "string",
"country": "string",
"state": "string",
"acronym": "string",
"legalFormCode": "string",
"localLegalFormCode": "string",
"localLegalFormName": "string",
"type": "string",
"activities": [
{
"code": "string",
"name": "string"
}
],
"fieldsOfActivity": [
"string"
],
"localActivities": [
{
"code": "string",
"name": "string",
"classification": "string"
}
],
"dateOfCreation": "string",
"status": "string",
"dateOfCessation": "string",
"workforce": 0,
"workforceRange": "string",
"headOffice": {
"addressLine1": "string",
"addressLine2": "string",
"postalCode": "string",
"city": "string",
"country": "string",
"countryCode": "string"
},
"commercialRegisterRegistrationStatus": "string",
"commercialRegisterRegistrationLocation": "string",
"commercialRegisterRegistrationDate": "string",
"commercialRegisterCessationDate": "string",
"shareCapital": 0,
"shareCapitalCurrency": "string",
"fiscalYearEnd": "string",
"nextFiscalYearEnd": "string",
"officers": [
{
"type": "string",
"role": "string",
"mention": "string",
"dateOfAppointment": "string",
"lastName": "string",
"firstName": "string",
"gender": "string",
"dateOfBirth": "string",
"birthYear": 0,
"dateOfBirthFormat": "string",
"nationality": "string",
"nationalityCode": "string",
"companyName": "string",
"companyNumber": "string",
"addressLine1": "string",
"addressLine2": "string",
"postalCode": "string",
"city": "string",
"country": "string",
"countryCode": "string",
"companies": [
{
"companyNumber": "string",
"name": "string"
}
]
}
],
"ubos": [
{
"type": "string",
"role": "string",
"mention": "string",
"dateOfAppointment": "string",
"lastName": "string",
"firstName": "string",
"gender": "string",
"dateOfBirth": "string",
"dateOfBirthFormat": "string",
"birthYear": 0,
"nationality": "string",
"nationalityCode": "string",
"companyName": "string",
"companyNumber": "string",
"addressLine1": "string",
"addressLine2": "string",
"postalCode": "string",
"city": "string",
"country": "string",
"countryCode": "string",
"companies": [
{
"companyNumber": "string",
"name": "string"
}
],
"percentageOfShares": 0,
"votingPercentage": 0
}
],
"financials": [
{
"type": "string",
"year": 0,
"financialsStartDate": "string",
"financialsEndDate": "string",
"depositDate": "string",
"currency": "string",
"availability": "string",
"ratios": {},
"relatedDocuments": [
{}
]
}
],
"documents": [
{
"type": "string",
"date": "string",
"fileAvailable": true,
"description": "string",
"fileToken": "string",
"fileFormat": "string"
}
],
"certificates": [
{
"type": "string",
"date": "string",
"fileAvailable": true,
"description": "string",
"fileToken": "string",
"fileFormat": "string"
}
],
"publications": [
{
"mentions": [
"string"
],
"type": "string",
"date": "string",
"source": "string",
"content": "string",
"fileToken": "string",
"language": "string",
"id": "string",
"link": "string",
"company": {}
}
],
"establishments": [
{
"number": "string",
"name": "string",
"tradeName": "string",
"acronym": "string",
"activities": [
{
"code": "string",
"name": "string"
}
],
"fieldsOfActivity": [
"string"
],
"localActivities": [
{
"code": "string",
"name": "string",
"classification": "string"
}
],
"dateOfCreation": "string",
"status": "string",
"dateOfCessation": "string",
"addressLine1": "string",
"addressLine2": "string",
"postalCode": "string",
"city": "string",
"country": "string",
"countryCode": "string"
}
],
"contacts": [
{
"type": "string",
"value": "string"
}
]
}Empty
Empty
Empty
{
"errors": [
{
"message": "The field must be a valid value",
"rule": "ruleName",
"field": "phone"
}
]
}Empty