Lister les fournisseurs
GET
/v1/suppliers
Permission read_products
Compte comme une lecture
Renvoie les fournisseurs du compte, avec leurs coordonnées et leur adresse, par identifiant croissant. C'est ici que se traduit le fournisseur.id d'un produit.
Le parcours se fait par curseur : tant que meta.has_more vaut true, rappelez l'adresse avec after égal à meta.next_after. Les éléments archivés ne sont renvoyés qu'avec archived=true.
Paramètres
limit |
Facultatif | Nombre d'éléments par page, de 1 à 100. 50 par défaut. |
after |
Facultatif | Curseur de parcours : ne renvoie que les éléments dont l'identifiant est supérieur. Absent ou 0 pour la première page, puis la valeur next_after de la réponse précédente. |
archived |
Facultatif | true pour inclure aussi les éléments archivés. false par défaut : seuls les éléments en service sont renvoyés. |
Exemple d'appel
curl "https://api.wanapos.com/v1/suppliers" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
Une page de fournisseurs.
| Champ | Type | Description |
|---|---|---|
data |
liste | Une page, par identifiant croissant. Liste vide s'il n'y a rien. |
data[].id |
entier |
Identifiant du fournisseur. C'est la valeur de fournisseur.id dans un produit. |
data[].name |
texte | Nom du fournisseur. |
data[].commercial1 |
texte | Nom du premier contact commercial. |
data[].commercial2 |
texte | Nom du second contact commercial. |
data[].tel |
texte | Téléphone. |
data[].mobile |
texte | Mobile. |
data[].email |
texte | Adresse mail. |
data[].tva_intra |
texte | Numéro de TVA intracommunautaire. |
data[].notes |
texte | Notes libres du commerçant. |
data[].archived |
booléen |
true si le fournisseur est archivé : il n'est plus proposé dans l'application, mais les produits qui le portent le gardent. |
data[].date_creation |
texte | Date de création. |
data[].date_update |
texte | Date de la dernière modification. Chaîne vide si inconnue. |
data[].adresse |
objet | Adresse du fournisseur. |
data[].adresse.ligne1 |
texte | Adresse, première ligne. |
data[].adresse.ligne2 |
texte | Complément d'adresse. |
data[].adresse.cp |
texte | Code postal. |
data[].adresse.ville |
texte | Ville. |
data[].adresse.id_pays |
entier |
Identifiant du pays (voir GET /v1/countries). 0 si non renseigné. |
data[].adresse.pays_code |
texte | Code du pays à deux lettres. |
data[].adresse.pays |
texte | Nom du pays en français. |
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel. |
meta.count |
entier | Nombre d'éléments dans cette page. |
meta.has_more |
booléen |
true s'il reste une page à lire. |
meta.next_after |
entier |
Valeur à passer dans after pour la page suivante. 0 quand le parcours est terminé. |
{
"data": [
{
"id": 7,
"name": "Maison Verdier",
"commercial1": "Julie Arnaud",
"commercial2": "",
"tel": "0472000000",
"mobile": "",
"email": "contact@maison-verdier.example",
"tva_intra": "",
"notes": "",
"archived": false,
"date_creation": "2026-03-14T10:22:00+01:00",
"date_update": "2026-10-02T16:05:00+02:00",
"adresse": {
"ligne1": "4 quai des Tanneurs",
"ligne2": "",
"cp": "69009",
"ville": "Lyon",
"id_pays": 63,
"pays_code": "FR",
"pays": "France"
}
}
],
"meta": {
"request_id": "3f9a1c0b7d2e4a61",
"count": 1,
"has_more": false,
"next_after": 0
}
}
Erreurs possibles
-
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
