Lister les valeurs d'une liste personnalisée
GET
/v1/custom-lists/{list}/values
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 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
