Classements

Lister les valeurs d'une liste personnalisée

GET /v1/custom-lists/{list}/values
vpn_key Permission read_products Compte comme une lecture

Renvoie les valeurs d'une des trois listes personnalisées, par identifiant croissant. C'est ici que se traduit l'identifiant porté par id_custom_list_1, id_custom_list_2 ou id_custom_list_3 dans 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

list Obligatoire Numéro de la liste personnalisée : 1, 2 ou 3 (voir GET /v1/custom-lists).
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/custom-lists/1/values" \
  -H "Authorization: Bearer VOTRE_CLE"

Réponse en cas de succès (statut 200)

Une page de valeurs.

Champ Type Description
data liste Une page, par identifiant croissant. Liste vide s'il n'y a rien.
data[].id entier Identifiant de la valeur. C'est ce que porte id_custom_list_1, id_custom_list_2 ou id_custom_list_3 dans un produit.
data[].id_list entier Numéro de la liste à laquelle la valeur appartient : 1, 2 ou 3.
data[].name texte Libellé de la valeur.
data[].archived booléen true si la valeur est archivée.
data[].date_creation texte Date de création.
data[].date_update texte Date de la dernière modification. Chaîne vide si inconnue.
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": 4,
            "id_list": 1,
            "name": "Coton bio",
            "archived": false,
            "date_creation": "2026-03-14T10:22:00+01:00",
            "date_update": "2026-10-02T16:05:00+02:00"
        }
    ],
    "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