Use this endpoint to search for companies and return a list of matching results, using the GET method.
Related B2B documentation:
- B2B introduction
- RECSIRET POST request
- RECSIRET response
- SIRETINFO GET request
- B2B Swagger documentation
RECSIRET GET request
The RECSIRET endpoint searches for companies and returns a list of matching results. It can be used with company name, company name and postal code, or postal address.
Company name only
Endpoint
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}Replace the values in braces with your own information:
| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Address of the DQE server that will process the data. | Mandatory |
| 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
Endpoint
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Address of the DQE server that will process the data. | Mandatory |
| 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
Endpoint
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&CP={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}| Parameter | Value | Description | Mandatory/Optional |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Address of the DQE server that will process the data. | Mandatory |
| 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