Listar suscripciones
Devuelve una lista paginada de las suscripciones de una cuenta.
merchant_reference no es un filtro en este endpointEnviarlo no tiene efecto: el parámetro se ignora y se devuelve la página completa, sin filtrar. Para buscar una suscripción por referencia del comercio, conserva el id que recibiste al crearla, o recorre las páginas de este endpoint y haz la coincidencia del lado del cliente.Alcance y orden
La lista siempre está limitada a la única cuenta indicada en el encabezadoX-Account-Code: no existe una variante entre cuentas. Los resultados se ordenan por created_at en orden descendente, por lo que una suscripción creada mientras recorres las páginas puede desplazar elementos entre los límites de página. Para un recorrido estable, filtra con created_at_to fijado en el momento en que empezaste.
Los filtros se pueden combinar y todos son opcionales; cada uno reduce aún más el conjunto de resultados. Si no se define ninguno, se devuelven las suscripciones en todos los estados, incluidas las CANCELED y COMPLETED.Autorizaciones
Encabezados
El account_id que se encuentra en tu Dashboard de Yuno (UUID). Obligatorio: la lista siempre se limita a una sola cuenta. Omitirlo devuelve 400 INVALID_PARAMETERS ("x-account-code header is required.").
Parámetros de consulta
Filtra por estado. Acepta varios valores separados por comas, que coinciden con cualquiera de ellos: ACTIVE,PAUSED. Los valores deben escribirse exactamente como en Estados de la suscripción; un valor desconocido devuelve 400 BAD_REQUEST ("Invalid status: FOO.").
"ACTIVE,PAUSED"
Filtra por el plan al que está vinculada la suscripción (UUID). Un plan sin suscriptores, o uno que no existe, devuelve una lista vacía, no un error. Un valor que no es un UUID devuelve 400 BAD_REQUEST ("Invalid plan_id.").
"00000000-0000-4000-8000-000000000001"