Company Search - B2B Classic API
Use this endpoint to search for companies and return a list of matching results. RECSIRET can be searched by company name, company name and postal code, or postal address.
Related B2B Classic API documentation:
Company Name Search — RECSIRET
Search for companies using a full or partial company name.
Company name only
Request
Both GET and POST are supported.
{SERVER_ADDRESS} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Code examples
Search for "DECATHLON"
curl "https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
CompanyName: "DECATHLON",
Dictionary: "Y",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"CompanyName": "DECATHLON",
"Dictionary": "Y",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'CompanyName' => 'DECATHLON',
'Dictionary' => 'Y',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/RECSIRET/', {
params: {
CompanyName: 'DECATHLON',
Dictionary: 'Y',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/RECSIRET/" +
"?CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/RECSIRET/" +
"?CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/RECSIRET/
Add the following parameters in the request body using x-www-form-urlencoded.
Code examples
Search for "DECATHLON"
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "CompanyName=DECATHLON" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
CompanyName: "DECATHLON",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"CompanyName": "DECATHLON",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'CompanyName' => 'DECATHLON',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
CompanyName: 'DECATHLON',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&CompanyName=DECATHLON&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["CompanyName"] = "DECATHLON",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("CompanyName", "DECATHLON")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameters
| Parameter | Value | Description | Mand / Opt |
|---|---|---|---|
| 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. |
| NAF25 | {NAF25} |
Get the new value of Sic Code in France or not : True / False | Optional. Default value: False
|
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. |
Test the API
Click the button below to test this endpoint live in your browser.
Open console
Company Name + Postal Code Search — RECSIRET
Narrow a company-name search by also passing a postal code or department code.
Company name and postal code
Request
Both GET and POST are supported.
{SERVER_ADDRESS} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Code examples
Search for "DECATHLON" in postal code 59650
curl "https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
ZIP_Code: "59650",
CompanyName: "DECATHLON",
Dictionary: "Y",
Country: "FRA",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"ZIP_Code": "59650",
"CompanyName": "DECATHLON",
"Dictionary": "Y",
"Country": "FRA",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'ZIP_Code' => '59650',
'CompanyName' => 'DECATHLON',
'Dictionary' => 'Y',
'Country' => 'FRA',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/RECSIRET/', {
params: {
ZIP_Code: '59650',
CompanyName: 'DECATHLON',
Dictionary: 'Y',
Country: 'FRA',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/RECSIRET/" +
"?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/RECSIRET/" +
"?ZIP_Code=59650&CompanyName=DECATHLON&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/RECSIRET/
Add the following parameters in the request body using x-www-form-urlencoded.
Code examples
Search for "DECATHLON" in postal code 59650
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "ZIP_Code=59650" \
-d "CompanyName=DECATHLON" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
ZIP_Code: "59650",
CompanyName: "DECATHLON",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"ZIP_Code": "59650",
"CompanyName": "DECATHLON",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'ZIP_Code' => '59650',
'CompanyName' => 'DECATHLON',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
ZIP_Code: '59650',
CompanyName: 'DECATHLON',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&ZIP_Code=59650&CompanyName=DECATHLON&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["ZIP_Code"] = "59650",
["CompanyName"] = "DECATHLON",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("ZIP_Code", "59650")
form.Set("CompanyName", "DECATHLON")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameters
| Parameter | Value | Description | Mand / Opt |
|---|---|---|---|
| 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. |
| NAF25 | {NAF25} |
Get the new value of Sic Code in France or not : True / False | Optional. Default value: False
|
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. |
Test the API
Click the button below to test this endpoint live in your browser.
Open console
Postal Address Search — RECSIRET
Search for companies using a street address, postal code and city — with no company name required.
Postal address only
Request
Both GET and POST are supported.
{SERVER_ADDRESS} and {LICENCE_CODE} are provided by DQE upon account creation. Contact your DQE account manager to obtain these credentials.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Code examples
Search by business address
curl "https://{SERVER_ADDRESS}/RECSIRET/?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&Licence={LICENCE_CODE}"
fetch("https://{SERVER_ADDRESS}/RECSIRET/?" + new URLSearchParams({
Address: "52 ALLEE LAKANAL",
PostalCode: "59650",
City: "VILLENEUVE D ASCQ",
Country: "FRA",
Dictionary: "Y",
Licence: "{LICENCE_CODE}"
}))
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.get(
"https://{SERVER_ADDRESS}/RECSIRET/",
params={
"Address": "52 ALLEE LAKANAL",
"PostalCode": "59650",
"City": "VILLENEUVE D ASCQ",
"Country": "FRA",
"Dictionary": "Y",
"Licence": "{LICENCE_CODE}",
},
)
print(response.json())
<?php
$params = http_build_query([
'Address' => '52 ALLEE LAKANAL',
'PostalCode' => '59650',
'City' => 'VILLENEUVE D ASCQ',
'Country' => 'FRA',
'Dictionary' => 'Y',
'Licence' => '{LICENCE_CODE}',
]);
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/?{$params}");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
axios.get('https://{SERVER_ADDRESS}/RECSIRET/', {
params: {
Address: '52 ALLEE LAKANAL',
PostalCode: '59650',
City: 'VILLENEUVE D ASCQ',
Country: 'FRA',
Dictionary: 'Y',
Licence: '{LICENCE_CODE}'
}
})
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String url = "https://{SERVER_ADDRESS}/RECSIRET/"
+ "?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&Licence={LICENCE_CODE}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var url = "https://{SERVER_ADDRESS}/RECSIRET/" +
"?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&Licence={LICENCE_CODE}";
var response = await client.GetAsync(url);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
url := "https://{SERVER_ADDRESS}/RECSIRET/" +
"?Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y&Licence={LICENCE_CODE}"
resp, err := http.Get(url)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
POSThttps://{SERVER_ADDRESS}/RECSIRET/
Add the following parameters in the request body using x-www-form-urlencoded.
Code examples
Search by business address
curl -X POST "https://{SERVER_ADDRESS}/RECSIRET/" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "Licence={LICENCE_CODE}" \
-d "Address=52 ALLEE LAKANAL" \
-d "PostalCode=59650" \
-d "City=VILLENEUVE D ASCQ" \
-d "Country=FRA" \
-d "Dictionary=Y"
fetch("https://{SERVER_ADDRESS}/RECSIRET/", {
method: "POST",
headers: { "Content-Type": "application/x-www-form-urlencoded" },
body: new URLSearchParams({
Licence: "{LICENCE_CODE}",
Address: "52 ALLEE LAKANAL",
PostalCode: "59650",
City: "VILLENEUVE D ASCQ",
Country: "FRA",
Dictionary: "Y"
})
})
.then(r => r.json())
.then(data => console.log(data));
import requests
response = requests.post(
"https://{SERVER_ADDRESS}/RECSIRET/",
data={
"Licence": "{LICENCE_CODE}",
"Address": "52 ALLEE LAKANAL",
"PostalCode": "59650",
"City": "VILLENEUVE D ASCQ",
"Country": "FRA",
"Dictionary": "Y",
},
)
print(response.json())
<?php
$ch = curl_init("https://{SERVER_ADDRESS}/RECSIRET/");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'Licence' => '{LICENCE_CODE}',
'Address' => '52 ALLEE LAKANAL',
'PostalCode' => '59650',
'City' => 'VILLENEUVE D ASCQ',
'Country' => 'FRA',
'Dictionary' => 'Y',
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
const axios = require('axios');
const qs = require('querystring');
axios.post('https://{SERVER_ADDRESS}/RECSIRET/', qs.stringify({
Licence: '{LICENCE_CODE}',
Address: '52 ALLEE LAKANAL',
PostalCode: '59650',
City: 'VILLENEUVE D ASCQ',
Country: 'FRA',
Dictionary: 'Y'
}))
.then(response => console.log(response.data));
HttpClient client = HttpClient.newHttpClient();
String form = "Licence={LICENCE_CODE}&Address=52%20ALLEE%20LAKANAL&PostalCode=59650&City=VILLENEUVE%20D%20ASCQ&Country=FRA&Dictionary=Y";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://{SERVER_ADDRESS}/RECSIRET/"))
.header("Content-Type", "application/x-www-form-urlencoded")
.POST(HttpRequest.BodyPublishers.ofString(form))
.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using var client = new HttpClient();
var form = new Dictionary<string, string> {
["Licence"] = "{LICENCE_CODE}",
["Address"] = "52 ALLEE LAKANAL",
["PostalCode"] = "59650",
["City"] = "VILLENEUVE D ASCQ",
["Country"] = "FRA",
["Dictionary"] = "Y"
};
var response = await client.PostAsync(
"https://{SERVER_ADDRESS}/RECSIRET/",
new FormUrlEncodedContent(form));
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
form := url.Values{}
form.Set("Licence", "{LICENCE_CODE}")
form.Set("Address", "52 ALLEE LAKANAL")
form.Set("PostalCode", "59650")
form.Set("City", "VILLENEUVE D ASCQ")
form.Set("Country", "FRA")
form.Set("Dictionary", "Y")
resp, err := http.PostForm("https://{SERVER_ADDRESS}/RECSIRET/", form)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Parameters
| Parameter | Value | Description | Mand / Opt |
|---|---|---|---|
| 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 |
| PostalCode | {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. |
| NAF25 | {NAF25} |
Get the new value of Sic Code in France or not : True / False | Optional. Default value: False
|
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. |
Test the API
Click the button below to test this endpoint live in your browser.
Open console
Response
The JSON response is a dictionary whose keys are DATA1, DATA2, etc. Each value is a dictionary containing the company's data. It contains the key SEARCH_REF which is required to retrieve full company details via SIRETINFO. This Response applies to all three search modes above.
| Key | Value | France | International |
|---|---|---|---|
| SEARCH_REF | Search reference, to use as input for SIRETINFO. | STRING | STRING |
| CompanyCName | Complementary name of the company (or trade name). | STRING(50) | STRING(255) |
| LegalStructureLabel | Legal form of the company (label). | STRING(100) | STRING(100) |
| IncorporationDate | Date of company installation in the current city. | STRING | STRING |
| MainCompanyFlag |
1: head office; 0: other company office. |
STRING(1) | STRING(1) |
| CompanyStatus |
1: company in operation; 0: company no longer in operation. |
STRING(1) | STRING(1) |
| CompanyName | Company name. | STRING(131) | STRING(255) |
| CompanyAddress2 | Company address. | STRING(38) | STRING(50) |
| CompanyAddress3 | Additional address information. | STRING(38) | STRING(50) |
| CompanyAddress1 | May include the second part of the CompanyName if the name is too long. | STRING(38) | STRING(50) |
| Locality | City of the company. | STRING(38) | STRING(50) |
| Phone | Not used anymore. | ||
| DissolutionDate | Date the company ceased to operate. | STRING | STRING |
| StaffCount | Number of employees. See StaffCount values below. | STRING | STRING |
| CompanySIC | Company NAF code. | STRING(5) | STRING |
| LegalStructureCode | Legal form of the company (code). | STRING(4) | STRING(4) |
| IntraNumber | Intra-Community VAT number. This field is empty if the company is not subject to VAT. |
STRING(15) | STRING |
| ZIP_Code | ZIP code of the company's city. | STRING(5) | STRING(10) |
| TurnOver | Not used anymore. | ||
| CompanyNumber | SIRET number of the company. | STRING(14) | STRING(14) |
| Country | ISO 3-letter country code. | STRING(3) | STRING(3) |
StaffCount values:
| StaffCount value |
|---|
| Not declared |
| Non-employer |
| 0 |
| 1-2 |
| 3-5 |
| 6-9 |
| 10-19 |
| 20-49 |
| 50-99 |
| 100-199 |
| 200-249 |
| 250-499 |
| 500-999 |
| 1000-1999 |
| 2000-4999 |
| 5000-9999 |
| 10000+ |
Response example
Example response — DECATHLON
{
"DATA1": {
"SEARCH_REF": "_13367292",
"CompanyCName": "",
"IncorporationDate": "2024-06-24",
"LegalStructureLabel": "Société européenne",
"CompanyStatus": "1",
"CompanyName": "DECATHLON",
"CompanyAddress1": "",
"CompanyAddress2": "52 ALLEE LAKANAL",
"CompanyAddress3": "",
"Locality": "VILLENEUVE D ASCQ",
"DissolutionDate": "",
"Phone": "",
"MainCompanyFlag": "0",
"StaffCount": "Non-employer",
"CompanySIC": "8559A",
"LegalStructureCode": "5800",
"IntraNumber": "FR 51 306138900",
"ZIP_Code": "59650",
"TurnOver": "",
"CompanyNumber": "306xxxxxxxxxxx",
"Country": "FRA"
}
}
Errors
Company name only
| Error type | Example request | Response |
|---|---|---|
Missing Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Empty Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
Missing or empty CompanyName parameter |
https://{SERVER_ADDRESS}/RECSIRET/?Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/RECSIRET/?CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
|
{
"DATA1": {
"SEARCH_REF": "",
"CompanyCName": "",
"IncorporationDate": "",
"MainCompanyFlag": "",
"CompanyStatus": "",
"CompanyName": "",
"CompanyAddress2": "",
"CompanyAddress3": "",
"CompanyNumber": "",
"CompanyAddress1": "",
"Locality": "",
"Phone": "",
"DissolutionDate": "",
"CompanySIC": "",
"LegalStructureCode": "",
"IntraNumber": "",
"LegalStructureLabel": "",
"TurnOver": "",
"ZIP_Code": "",
"StaffCount": ""
}
} |
| Error on a parameter | https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Same empty response as above |
Company name and postal code
| Error type | Example request | Response |
|---|---|---|
Missing Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
Empty response |
Empty Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
Empty response |
Missing or empty CompanyName parameter |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName=&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE}
|
Same empty response as above |
Postal address only
| Error type | Example request | Response |
|---|---|---|
Missing Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Empty Licence parameter |
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
| Error on a parameter | https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Same empty response as above |
See also
Related to