# List subscriptions Répertorie tous les abonnements récurrents.Remarque Cette méthode API ne peut pas être utilisée en cas de charge élevée. La charge maximale est de 20 requêtes par minute. Remarque Cet appel API ne contient pas le paramètre de chemin project_id, vous devez donc utiliser la clé API valide dans tous les projets de l'entreprise pour l'autorisation. Endpoint: GET /merchants/{merchant_id}/subscriptions Version: 2.0 Security: basicAuth ## Path parameters: - `merchant_id` (integer, required) ID de commerçant. ## Query parameters: - `offset` (integer) Numéro de l'élément à partir duquel la liste est générée (le décompte commence à 0). - `limit` (integer, required) Nombre maximal d'éléments sur une page. - `user_id` (string) ID utilisateur. - `project_id[]` (array) Liste des ID des projets. - `plan_id[]` (array) Liste des ID des plans d'abonnement. - `product_id[]` (array) Liste des ID des produits auxquels les plans sont liés. - `group_id[]` (array) Liste des ID des groupes auxquels les plans sont liés. - `status[]` (array) Statut. Enum: "active", "canceled", "non_renewing" - `datetime_from` (string) Date de l'échantillon. Permet de rechercher les abonnements créés après la requête. - `datetime_to` (string) Date de l'échantillon. Permet de rechercher les abonnements créés après la requête. ## Response 200 fields (application/json): - `charge_amount` (number) Montant de facturation. - `comment` (string) Raison du changement de statut de l'abonnement - `currency` (string) Devise d'achat. Code de devise à trois lettres selon la norme ISO 4217. - `date_create` (string) Date de création de l'abonnement au format YYYY-MM-DD’T’HH:MM:SS selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `date_end` (string) Date de fin d'abonnement au format YYYY-MM-DD’T’HH:MM:SS selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `date_last_charge` (string,null) Date de la dernière facturation de l'abonnement au format YYYY-MM-DD’T’HH:MM:SS selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `date_next_charge` (string,null) Date de la prochaine facturation de l'abonnement au format YYYY-MM-DD’T’HH:MM:SS selon la norme [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601). - `id` (integer) ID d'abonnement - `plan` (object) - `plan.billing_retry` (object) Informations sur la relance de la facturation. - `plan.billing_retry.value` (integer, required) Nombre de relances de facturation. - `plan.charge` (object) Informations de facturation. - `plan.charge.amount` (number) Montant de facturation. - `plan.charge.currency` (string) Devise d'achat. Code de devise à trois lettres selon la norme [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217). - `plan.charge.period` (object, required) Période de facturation. - `plan.charge.period.type` (string, required) Unité de temps. La valeur peut être day, month ou lifetime. Enum: "day", "month", "lifetime" - `plan.charge.period.value` (integer, required) Nombre d'unités de temps. La valeur dépend du paramètre type et peut être : - de 1 à 366, si type est défini sur day ;- de 1 à 12, si type est défini sur month ;- 0 si type est défini sur lifetime. - `plan.charge.prices` (array) Liste des prix dans différentes devises. - `plan.charge.prices.setup_fee` (number) Frais de mise en service uniques facturés dans le cadre de la première facture. - `plan.description` (object) Description du plan. La valeur est constituée de paires "localization":"plan description". - `plan.description.ar` (string) Arabe. - `plan.description.bg` (string) Bulgare. - `plan.description.cn` (string) Chinois (simplifié). - `plan.description.cs` (string) Tchèque. - `plan.description.de` (string) Allemand. - `plan.description.en` (string) Anglais. - `plan.description.es` (string) Espagnol. - `plan.description.fr` (string) Français. - `plan.description.he` (string) Hébreu. - `plan.description.it` (string) Italien. - `plan.description.ja` (string) Japonais. - `plan.description.ko` (string) Coréen. - `plan.description.pl` (string) Polonais. - `plan.description.pt` (string) Portugais. - `plan.description.ro` (string) Roumain. - `plan.description.ru` (string) Russe. - `plan.description.th` (string) Thaïlandais. - `plan.description.tr` (string) Turc. - `plan.description.tw` (string) Chinois (traditionnel). - `plan.description.vi` (string) Vietnamien. - `plan.expiration` (object) Informations sur l'expiration de l'abonnement. - `plan.expiration.type` (string, required) Unité de temps. La valeur peut être day ou month. Enum: "day", "month" - `plan.expiration.value` (integer,null, required) Durée de validité. - `plan.external_id` (string) ID externe du plan (32 caractères). - `plan.grace_period` (object) Informations sur le délai de grâce. - `plan.grace_period.type` (string, required) Unité de temps. L'unique valeur possible est day. Enum: "day" - `plan.grace_period.value` (integer, required) Nombre d'unités de temps. - `plan.group_id` (string,null) ID du groupe auquel le plan est lié. - `plan.id` (integer) ID de plan d'abonnement. - `plan.name` (object) Nom du plan. La valeur est constituée de paires "localization":"plan name". - `plan.project_id` (integer) ID de projet. - `plan.refund_period` (integer,null) Période durant laquelle l'utilisateur peut se faire rembourser le paiement d'un abonnement (en jours). - `plan.status` (object) - `plan.status.value` (string) Statut de plan d'abonnement. Enum: "active", "disabled" - `plan.tags` (array) Balises du plan. - `plan.trial` (object) Informations sur la période d'essai. - `product` (object,null) - `product.id` (integer,null) ID du produit auquel les plans sont liés. - `product.description` (object) Descriptions localisées de l'objet. - `product.group_id` (string) ID du groupe auquel le produit est lié. - `product.name` (string) Nom du produit. - `status` (string) Statut Enum: "new", "active", "canceled", "non_renewing", "freeze" - `user` (object) - `user.id` (string) ID utilisateur - `user.name` (string) Nom d'utilisateur