Classements

Lister les fournisseurs

GET /v1/suppliers
vpn_key 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 champ field nomme le paramètre.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com