Use this Restful endpoint to search for companies and return a list of matching results, using the POST method.
Related B2B Restful documentation:
- B2B introduction
- Restful B2B Lookup GET request
- Restful B2B Lookup response
- Restful B2B GetInfo POST request
- Restful B2B Swagger documentation
Restful B2B Lookup POST request
The Lookup endpoint searches for companies and returns a list of matching results.
Endpoint
POST https://{SERVER_ADDRESS}/b2b/lookupSend the following parameters in the request body using JSON.
| Parameter | Description | Mandatory/Optional |
|---|---|---|
| country | ISO 3-letter country code. | Mandatory |
| companyName | Company name or part of the company name. | Mandatory for company-name search |
| zipCode | Postal code or department code. | Optional |
| address | Street type and street name of the business address. | Mandatory for address search |
| city | City name of the business address. | Mandatory for address search |
| filter | Company status filter. Several values can be separated by commas. | Optional. Default value: 1. |
| limit | Maximum number of results to return. | Optional. Default value: 10. |
Example:
{
"country": "FRA",
"companyName": "DQE",
"zipCode": "92300",
"filter": "1",
"limit": 10
}Filter values
| Value | Description |
|---|---|
1 |
Opened diffusible companies. |
2 |
Closed diffusible companies. |
3 |
Closed old diffusible companies older than 3 years. |
4 |
Non-diffusible companies. |
5 |
RNA records. |
Related to