Recherche d’entreprises - API B2B Classic
Utilisez ce endpoint pour rechercher des entreprises et obtenir une liste de résultats correspondants. RECSIRET peut être interrogé par nom d’entreprise, par nom d’entreprise et code postal, ou par adresse postale.
Documentation API B2B Classic associée :
Recherche par nom d’entreprise — RECSIRET
Recherchez des entreprises à partir d’un nom d’entreprise complet ou partiel.
Nom d’entreprise uniquement
Requête
GET et POST sont toutes deux prises en charge.
{SERVER_ADDRESS} et {LICENCE_CODE} sont fournis par DQE à la création du compte. Contactez votre chargé de compte DQE pour obtenir ces identifiants.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Exemples de code
Recherche de « 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/
Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.
Exemples de code
Recherche de « 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))
}
Paramètres
| Paramètre | Valeur | Description | Obl / Opt |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Adresse du serveur DQE qui traitera les données. | Obligatoire |
| Licence | {LICENCE_CODE} |
Code de licence attribué à votre compte. | Obligatoire |
| CompanyName | {COMPANY_NAME} |
Nom de l’entreprise ou partie du nom de l’entreprise. | Obligatoire |
| Country | {COUNTRY_CODE} |
Code pays ISO à 3 lettres. | Obligatoire |
| Dictionary | Y |
Active la recherche d’entreprise basée sur le dictionnaire. | Obligatoire |
| Filter | {FILTER} |
Filtre de statut d’entreprise. Plusieurs valeurs peuvent être séparées par des virgules. | Optionnel. Valeur par défaut : 1. |
| NbMax | {NB_MAX} |
Nombre maximum de résultats à retourner. | Optionnel. Valeur par défaut : 10. |
| NAF25 | {NAF25} |
Obtenir ou non la nouvelle valeur du Code Sic en France : True / False | Optionnel. Valeur par défaut : False
|
Valeurs du filtre
| Valeur | Description |
|---|---|
| 1 | Entreprises diffusibles ouvertes. |
| 2 | Entreprises diffusibles fermées. |
| 3 | Anciennes entreprises diffusibles fermées depuis plus de 3 ans. |
| 4 | Entreprises non diffusibles. |
| 5 | Enregistrements RNA. |
Tester l’API
Cliquez sur le bouton ci-dessous pour tester cet endpoint en direct dans votre navigateur.
Ouvrir la console
Recherche par nom d’entreprise et code postal — RECSIRET
Affinez une recherche par nom d’entreprise en ajoutant un code postal ou un code département.
Nom d’entreprise et code postal
Requête
GET et POST sont toutes deux prises en charge.
{SERVER_ADDRESS} et {LICENCE_CODE} sont fournis par DQE à la création du compte. Contactez votre chargé de compte DQE pour obtenir ces identifiants.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country={COUNTRY_CODE}&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Exemples de code
Recherche de « DECATHLON » dans le code postal 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/
Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.
Exemples de code
Recherche de « DECATHLON » dans le code postal 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))
}
Paramètres
| Paramètre | Valeur | Description | Obl / Opt |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Adresse du serveur DQE qui traitera les données. | Obligatoire |
| Licence | {LICENCE_CODE} |
Code de licence attribué à votre compte. | Obligatoire |
| ZIP_Code | {POSTAL_CODE} |
Code postal ou code département. | Obligatoire |
| CompanyName | {COMPANY_NAME} |
Nom de l’entreprise. | Obligatoire |
| Country | {COUNTRY_CODE} |
Code pays ISO à 3 lettres. | Obligatoire |
| Dictionary | Y |
Active la recherche d’entreprise basée sur le dictionnaire. | Obligatoire |
| Filter | {FILTER} |
Filtre de statut d’entreprise. Plusieurs valeurs peuvent être séparées par des virgules. | Optionnel. Valeur par défaut : 1. |
| NbMax | {NB_MAX} |
Nombre maximum de résultats à retourner. | Optionnel. Valeur par défaut : 10. |
| NAF25 | {NAF25} |
Obtenir ou non la nouvelle valeur du Code Sic en France : True / False | Optionnel. Valeur par défaut : False
|
Valeurs du filtre
| Valeur | Description |
|---|---|
| 1 | Entreprises diffusibles ouvertes. |
| 2 | Entreprises diffusibles fermées. |
| 3 | Anciennes entreprises diffusibles fermées depuis plus de 3 ans. |
| 4 | Entreprises non diffusibles. |
| 5 | Enregistrements RNA. |
Tester l’API
Cliquez sur le bouton ci-dessous pour tester cet endpoint en direct dans votre navigateur.
Ouvrir la console
Recherche par adresse postale — RECSIRET
Recherchez des entreprises à partir d’une adresse, d’un code postal et d’une ville — sans nom d’entreprise requis.
Adresse postale uniquement
Requête
GET et POST sont toutes deux prises en charge.
{SERVER_ADDRESS} et {LICENCE_CODE} sont fournis par DQE à la création du compte. Contactez votre chargé de compte DQE pour obtenir ces identifiants.
GEThttps://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Country={COUNTRY_CODE}&Dictionary=Y&Licence={LICENCE_CODE}&Filter={FILTER}&NbMax={NB_MAX}
Exemples de code
Recherche par adresse d’entreprise
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/
Ajoutez les paramètres suivants dans le corps de la requête au format x-www-form-urlencoded.
Exemples de code
Recherche par adresse d’entreprise
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))
}
Paramètres
| Paramètre | Valeur | Description | Obl / Opt |
|---|---|---|---|
| SERVER_ADDRESS | {SERVER_ADDRESS} |
Adresse du serveur DQE qui traitera les données. | Obligatoire |
| Licence | {LICENCE_CODE} |
Code de licence attribué à votre compte. | Obligatoire |
| Address | {ADDRESS} |
Type de voie et nom de voie de l’adresse de l’entreprise à vérifier. | Obligatoire |
| PostalCode | {POSTAL_CODE} |
Code postal de l’adresse de l’entreprise à vérifier. | Obligatoire |
| City | {CITY} |
Nom de la ville de l’adresse de l’entreprise à vérifier. | Obligatoire |
| Country | {COUNTRY_CODE} |
Code pays ISO à 3 lettres. | Obligatoire |
| Dictionary | Y |
Active la recherche d’entreprise basée sur le dictionnaire. | Obligatoire |
| Filter | {FILTER} |
Filtre de statut d’entreprise. Plusieurs valeurs peuvent être séparées par des virgules. | Optionnel. Valeur par défaut : 1. |
| NbMax | {NB_MAX} |
Nombre maximum de résultats à retourner. | Optionnel. Valeur par défaut : 10. |
| NAF25 | {NAF25} |
Obtenir ou non la nouvelle valeur du Code Sic en France : True / False | Optionnel. Valeur par défaut : False
|
Valeurs du filtre
| Valeur | Description |
|---|---|
| 1 | Entreprises diffusibles ouvertes. |
| 2 | Entreprises diffusibles fermées. |
| 3 | Anciennes entreprises diffusibles fermées depuis plus de 3 ans. |
| 4 | Entreprises non diffusibles. |
| 5 | Enregistrements RNA. |
Tester l’API
Cliquez sur le bouton ci-dessous pour tester cet endpoint en direct dans votre navigateur.
Ouvrir la console
Réponse
La réponse JSON est un dictionnaire dont les clés sont DATA1, DATA2, etc. Chaque valeur est un dictionnaire contenant les données de l’entreprise. Elle contient la clé SEARCH_REF, nécessaire pour récupérer les informations complètes de l’entreprise via SIRETINFO. Cette réponse s’applique aux trois modes de recherche ci-dessus.
| Clé | Valeur | France | International |
|---|---|---|---|
| SEARCH_REF | Référence de recherche, à utiliser en entrée de SIRETINFO. | STRING | STRING |
| CompanyCName | Nom complémentaire de l’entreprise (ou nom commercial). | STRING(50) | STRING(255) |
| LegalStructureLabel | Forme juridique de l’entreprise (libellé). | STRING(100) | STRING(100) |
| IncorporationDate | Date d’installation de l’entreprise dans la ville actuelle. | STRING | STRING |
| MainCompanyFlag |
1 : siège social ; 0 : autre établissement de l’entreprise. |
STRING(1) | STRING(1) |
| CompanyStatus |
1 : entreprise en activité ; 0 : entreprise qui n’est plus en activité. |
STRING(1) | STRING(1) |
| CompanyName | Nom de l’entreprise. | STRING(131) | STRING(255) |
| CompanyAddress2 | Adresse de l’entreprise. | STRING(38) | STRING(50) |
| CompanyAddress3 | Informations complémentaires d’adresse. | STRING(38) | STRING(50) |
| CompanyAddress1 | Peut contenir la deuxième partie du CompanyName si le nom est trop long. | STRING(38) | STRING(50) |
| Locality | Ville de l’entreprise. | STRING(38) | STRING(50) |
| Phone | N’est plus utilisé. | ||
| DissolutionDate | Date à laquelle l’entreprise a cessé son activité. | STRING | STRING |
| StaffCount | Nombre d’employés. Voir les valeurs de StaffCount ci-dessous. | STRING | STRING |
| CompanySIC | Code NAF de l’entreprise. | STRING(5) | STRING |
| LegalStructureCode | Forme juridique de l’entreprise (code). | STRING(4) | STRING(4) |
| IntraNumber | Numéro de TVA intracommunautaire. Ce champ est vide si l’entreprise n’est pas assujettie à la TVA. |
STRING(15) | STRING |
| ZIP_Code | Code postal de la ville de l’entreprise. | STRING(5) | STRING(10) |
| TurnOver | N’est plus utilisé. | ||
| CompanyNumber | Numéro SIRET de l’entreprise. | STRING(14) | STRING(14) |
| Country | Code pays ISO à 3 lettres. | STRING(3) | STRING(3) |
Valeurs de StaffCount :
| Valeur de StaffCount |
|---|
| 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+ |
Exemple de réponse
Exemple de réponse — 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"
}
}
Erreurs
Nom d’entreprise uniquement
| Type d’erreur | Exemple de requête | Réponse |
|---|---|---|
Paramètre Licence manquant |
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Paramètre Licence vide |
https://{SERVER_ADDRESS}/RECSIRET/?CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
Paramètre CompanyName manquant ou vide |
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": ""
}
} |
| Erreur sur un paramètre | https://{SERVER_ADDRESS}/RECSIRET/?Companyame={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Même réponse vide que ci-dessus |
Nom d’entreprise et code postal
| Type d’erreur | Exemple de requête | Réponse |
|---|---|---|
Paramètre Licence manquant |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA |
Réponse vide |
Paramètre Licence vide |
https://{SERVER_ADDRESS}/RECSIRET/?ZIP_Code={POSTAL_CODE}&CompanyName={COMPANY_NAME}&Dictionary=Y&Country=FRA&Licence= |
Réponse vide |
Paramètre CompanyName manquant ou vide |
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}
|
Même réponse vide que ci-dessus |
Adresse postale uniquement
| Type d’erreur | Exemple de requête | Réponse |
|---|---|---|
Paramètre Licence manquant |
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA |
400 Bad Request Error |
Paramètre Licence vide |
https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence= |
400 Bad Request Error |
| Erreur sur un paramètre | https://{SERVER_ADDRESS}/RECSIRET/?Address={ADDRESS}&PostalCode={POSTAL_CODE}&City={CITY}&Dictionary=Y&Country=FRA&Licence={LICENCE_CODE} |
Même réponse vide que ci-dessus |
Voir aussi
Associé à