Use this endpoint to search for companies and return a list of matching results, using the POST method.
Related B2B documentation:
- B2B introduction
- RECSIRET GET request
- RECSIRET response
- SIRETINFO POST request
- B2B Swagger documentation
RECSIRET POST request
The RECSIRET endpoint can also be called using the POST method. This method is recommended when sending a large amount of data or when avoiding URL parameter limitations.
Endpoint
https://{SERVER_ADDRESS}/RECSIRET/Add the following parameters in the request body using x-www-form-urlencoded.
Company name only
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| Licence | {LICENCE_CODE} |
Licence code assigned to your account. | Mandatory |
| CompanyName | {COMPANY_NAME} |
Company name or part of the company name. | Mandatory |
| Country | {COUNTRY_CODE} |
ISO 3-letter country code. | Mandatory |
| Dictionary | Y |
Enables dictionary-based company search. | Mandatory |
| Filter | {FILTER} |
Company status filter. Several values can be separated by commas. | Optional. Default value: 1. |
| NbMax | {NB_MAX} |
Maximum number of results to return. | Optional. Default value: 10. |
Company name and postal code
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| Licence | {LICENCE_CODE} |
Licence code assigned to your account. | Mandatory |
| ZIP_Code | {POSTAL_CODE} |
Postal code or department code. | Mandatory |
| CompanyName | {COMPANY_NAME} |
Company name. | Mandatory |
| Country | {COUNTRY_CODE} |
ISO 3-letter country code. | Mandatory |
| Dictionary | Y |
Enables dictionary-based company search. | Mandatory |
| Filter | {FILTER} |
Company status filter. Several values can be separated by commas. | Optional. Default value: 1. |
| NbMax | {NB_MAX} |
Maximum number of results to return. | Optional. Default value: 10. |
Postal address only
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| Licence | {LICENCE_CODE} |
Licence code assigned to your account. | Mandatory |
| Address | {ADDRESS} |
Street type and street name of the business address to check. | Mandatory |
| CP | {POSTAL_CODE} |
Postal code of the business address to check. | Mandatory |
| City | {CITY} |
City name of the business address to check. | Mandatory |
| Country | {COUNTRY_CODE} |
ISO 3-letter country code. | Mandatory |
| Dictionary | Y |
Enables dictionary-based company search. | Mandatory |
| Filter | {FILTER} |
Company status filter. Several values can be separated by commas. | Optional. Default value: 1. |
| NbMax | {NB_MAX} |
Maximum number of results to return. | Optional. Default value: 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