Skip to main content
GET
Listar membresías

Authorizations

Authorization
string
header
required

Clave del negocio. sk es una clave completa (todo lo que el rol de quien la creó puede dar) y rk una restringida a los permisos que se eligieron al crearla. Solo se usa desde un servidor: un pedido desde un navegador se rechaza con browser_not_allowed.

Headers

Craqui-Version
string

Versión de la API para este pedido (YYYY-MM-DD). Si no la mandas, se usa la versión fijada en la clave cuando se creó.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2026-12-01"

Query Parameters

client_id
string

Solo lo de este cliente. Id de un cliente del estudio.

Pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"cli_01hzx8m4k2a7d9q3f5w6y8z0bc"

membership_plan_id
string

Solo las membresías de este plan. Id de un plan de membresía.

Pattern: ^mpl_[0-7][0-9a-hjkmnp-tv-z]{25}$
Example:

"mpl_01hzx8m4k2a7d9q3f5w6y8z0bc"

status
enum<string>

Solo las membresías en este estado.

Available options:
active,
paused,
suspended,
pending_payment,
cancelled,
expired
renews_at[lte]
string<date-time>

Solo las que se renuevan solas hasta este instante: active, con un plan que se renueva solo y el período terminando hasta ese momento. Instante en RFC 3339 con el offset del negocio en ese momento.

Example:

"2026-11-05T19:00:00-03:00"

limit
integer
default:20

Cuántos elementos traer, de 1 a 100.

Required range: 1 <= x <= 100
starting_after
string

El next_cursor de la página anterior. Sirve solo para la misma ruta con los mismos filtros: con otros, la respuesta es invalid_cursor.

Response

OK.

object
string
required
Allowed value: "list"
data
object[]
required
has_more
boolean
required

Si hay más elementos después de esta página.

next_cursor
string | null
required

Pásalo en starting_after para pedir la página siguiente. null si no hay más.