POST /explore/one
Retrieves company data by name or VAT number, with optional filters for country, postal code, and region. If searching by name, returns up to 5 possible matches; if by VAT number, returns a single exact match.
Request Body
| Field | Type | Description |
|---|---|---|
companyName |
String | Company name (optional, but at least one of companyName or vatTaxNumber is required) |
country |
String | Country ISO2 code (required) |
vatTaxNumber |
String | VAT ID (optional, but at least one of companyName or vatTaxNumber is required) |
postCode |
String | Postal code (optional) |
region |
String | Region (optional, value from GET Regions endpoint). See here |
Response 200
| Field | Type | Description |
|---|---|---|
companies |
Company[] | Array of found company objects (max 5 for name search, 1 for VAT number) |
Company
See the Company Object section for detailed field descriptions.
Example
{
"companies": []
}
Example curl call
curl -X POST "/explore/one" \
-H "x-api-key: <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"companyName": "Matchplat Srl",
"country": "IT",
"vatTaxNumber": "",
"postCode": "",
"region": ""
}'