> ## Documentation Index
> Fetch the complete documentation index at: https://docs.craqui.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Listar cuotas

> Las cuotas del estudio (membresías, packs, ofertas de bienvenida y pagos adelantados), de la más nueva a la
más vieja. Un mes cubierto por un pago adelantado viene `covered` y no se debe.

Paginada por cursor: para sincronizar todo, pide `limit=100` y sigue `next_cursor`.

Solo para estudios: en una academia responde `wrong_vertical`. Un parámetro que la ruta no
declara responde `validation_failed` con `unknown_parameter`.




## OpenAPI

````yaml /openapi.yaml get /fees
openapi: 3.1.0
info:
  title: API de Craqui
  version: '2026-12-01'
  summary: Conecta tu web o tu sistema a tu estudio o academia en Craqui.
  description: >
    API REST de Craqui. Cada clave pertenece a un solo negocio (un estudio o una
    academia) y todo lo

    que devuelve es de ese negocio.


    - **Autenticación:** `Authorization: Bearer <clave>`. Las claves se crean en
    Configuración →
      Integraciones. Una clave `crq_live_` usa los datos reales del negocio; una `crq_test_` usa su
      estudio de prueba: la misma configuración (sedes, clases, packs, planes) con clientes y
      reservas de ejemplo, que no le escribe a nadie. La URL es la misma: el entorno lo decide la
      clave. Todo objeto dice en `livemode` de cuál de los dos viene.
    - **Versión:** cada clave queda fijada a la versión vigente cuando se creó.
    El header
      `Craqui-Version` la sobrescribe por pedido, y la respuesta siempre dice cuál se usó.
    - **Errores:** `application/problem+json` (RFC 9457), con un `code` estable
    para programar y un
      `request_id` para buscar el pedido en tu panel.
    - **Montos:** enteros en `amount_cents` (siempre ×100) junto con la moneda
    ISO 4217.

    - **Fechas y horas:** instantes en RFC 3339 con el offset del negocio;
    fechas sin hora como
      `YYYY-MM-DD` en la fecha local del negocio.
  contact:
    name: Craqui
    url: https://craqui.com
servers:
  - url: https://api.craqui.com/v1
    description: Producción
security:
  - bearerAuth: []
tags:
  - name: business
    description: El negocio al que pertenece la clave (un estudio o una academia).
  - name: booking_policy
    description: Las reglas de reserva del estudio. Solo estudios.
  - name: centers
    description: Las sedes del estudio. Solo estudios.
  - name: rooms
    description: Los salones de cada sede. Solo estudios.
  - name: teachers
    description: Quienes dan clases en el estudio. Solo estudios.
  - name: courses
    description: Las disciplinas del estudio (Yoga, Pilates…). Solo estudios.
  - name: classes
    description: Las clases con su horario semanal. Solo estudios.
  - name: sessions
    description: El horario del estudio, sesión por sesión, con sus lugares. Solo estudios.
  - name: clients
    description: >-
      Los clientes del estudio, con el contacto separado en su propio permiso.
      Solo estudios.
  - name: bookings
    description: Las reservas de las sesiones. Solo estudios.
  - name: credit_packs
    description: Los packs de créditos que vende el estudio. Solo estudios.
  - name: membership_plans
    description: Los planes de membresía que vende el estudio. Solo estudios.
  - name: intro_offers
    description: Las ofertas de bienvenida que vende el estudio. Solo estudios.
  - name: credits
    description: Los créditos de los clientes, sus lotes y sus movimientos. Solo estudios.
  - name: memberships
    description: Las membresías de los clientes y sus congelamientos. Solo estudios.
  - name: fees
    description: Las cuotas que el estudio le cobra a cada cliente. Solo estudios.
  - name: payments
    description: Los pagos de las cuotas. Solo estudios.
  - name: refunds
    description: Los reembolsos de los pagos. Solo estudios.
paths:
  /fees:
    get:
      tags:
        - fees
      summary: Listar cuotas
      description: >
        Las cuotas del estudio (membresías, packs, ofertas de bienvenida y pagos
        adelantados), de la más nueva a la

        más vieja. Un mes cubierto por un pago adelantado viene `covered` y no
        se debe.


        Paginada por cursor: para sincronizar todo, pide `limit=100` y sigue
        `next_cursor`.


        Solo para estudios: en una academia responde `wrong_vertical`. Un
        parámetro que la ruta no

        declara responde `validation_failed` con `unknown_parameter`.
      operationId: listFees
      parameters:
        - $ref: '#/components/parameters/CraquiVersion'
        - $ref: '#/components/parameters/ClientIdFilter'
        - name: type
          in: query
          required: false
          description: Solo las cuotas de este tipo.
          schema:
            type: string
            enum:
              - membership
              - credit_pack
              - intro_offer
              - advance_payment
        - name: status
          in: query
          required: false
          description: Solo las cuotas en este estado.
          schema:
            type: string
            enum:
              - open
              - overdue
              - paid
              - refunded
              - void
              - covered
        - name: due_date[gte]
          in: query
          required: false
          description: Solo las cuotas que vencen desde esta fecha local, incluida.
          schema:
            $ref: '#/components/schemas/LocalDate'
        - name: due_date[lte]
          in: query
          required: false
          description: Solo las cuotas que vencen hasta esta fecha local, incluida.
          schema:
            $ref: '#/components/schemas/LocalDate'
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/StartingAfter'
      responses:
        '200':
          description: OK.
          headers:
            Request-Id:
              $ref: '#/components/headers/RequestId'
            Craqui-Version:
              $ref: '#/components/headers/CraquiVersion'
            RateLimit:
              $ref: '#/components/headers/RateLimit'
            RateLimit-Policy:
              $ref: '#/components/headers/RateLimitPolicy'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeeList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          $ref: '#/components/responses/Conflict'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalError'
components:
  parameters:
    CraquiVersion:
      name: Craqui-Version
      in: header
      required: false
      description: >
        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ó.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
        examples:
          - '2026-12-01'
    ClientIdFilter:
      name: client_id
      in: query
      required: false
      description: Solo lo de este cliente.
      schema:
        $ref: '#/components/schemas/ClientId'
    Limit:
      name: limit
      in: query
      required: false
      description: Cuántos elementos traer, de 1 a 100.
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
    StartingAfter:
      name: starting_after
      in: query
      required: false
      schema:
        type: string
      description: >
        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`.
  schemas:
    LocalDate:
      type: string
      format: date
      description: Fecha local del negocio, `YYYY-MM-DD`.
      pattern: ^\d{4}-\d{2}-\d{2}$
      examples:
        - '2026-11-05'
    FeeList:
      allOf:
        - $ref: '#/components/schemas/List'
        - type: object
          properties:
            data:
              type: array
              items:
                $ref: '#/components/schemas/Fee'
    ClientId:
      type: string
      description: Id de un cliente del estudio.
      pattern: ^cli_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - cli_01hzx8m4k2a7d9q3f5w6y8z0bc
    List:
      type: object
      required:
        - object
        - data
        - has_more
        - next_cursor
      properties:
        object:
          type: string
          const: list
        data:
          type: array
          items: {}
        has_more:
          type: boolean
          description: Si hay más elementos después de esta página.
        next_cursor:
          type:
            - string
            - 'null'
          description: >-
            Pásalo en `starting_after` para pedir la página siguiente. `null` si
            no hay más.
    Fee:
      type: object
      description: >
        Una cuota que el estudio le cobra a un cliente: una membresía, un pack,
        una oferta de bienvenida o un

        pago adelantado de varios meses.
      required:
        - id
        - object
        - livemode
        - client_id
        - type
        - due_date
        - amount_due
        - amount_paid
        - amount_refunded
        - status
        - membership_id
        - credit_grant_id
        - advance_payment_fee_id
        - created_at
      properties:
        id:
          $ref: '#/components/schemas/FeeId'
        object:
          type: string
          const: fee
        livemode:
          type: boolean
          description: >-
            `false` si el objeto es de tu estudio de prueba (claves
            `crq_test_`); `true` con claves `crq_live_`.
        client_id:
          description: >-
            El cliente. `null` si la cuota es de alguien que no es cliente del
            estudio.
          oneOf:
            - $ref: '#/components/schemas/ClientId'
            - type: 'null'
        type:
          type: string
          description: >
            `membership`, `credit_pack`, `intro_offer` o `advance_payment` (un
            pago adelantado que cubre varios

            meses de una membresía). La lista puede crecer.
          enum:
            - membership
            - credit_pack
            - intro_offer
            - advance_payment
          x-extensible-enum: true
        due_date:
          $ref: '#/components/schemas/LocalDate'
        amount_due:
          $ref: '#/components/schemas/Money'
          description: >
            El monto de la cuota. En una cuota `covered` es el precio que
            hubiera tenido ese mes: **no se

            debe**, porque lo pagó el pago adelantado.
        amount_paid:
          $ref: '#/components/schemas/Money'
        amount_refunded:
          $ref: '#/components/schemas/Money'
        status:
          type: string
          description: >
            - `open`: a pagar, todavía en fecha.

            - `overdue`: vencida y sin pagar.

            - `paid`: pagada (también si después se devolvió una parte).

            - `refunded`: se devolvió entera.

            - `void`: anulada; no se debe.

            - `covered`: un mes que cubre un pago adelantado
            (`advance_payment_fee_id`); no se debe.


            Para saber cuánto debe un cliente, suma `amount_due − amount_paid`
            solo de las cuotas `open` y

            `overdue`. La lista puede crecer: trata un valor que no conoces como
            una cuota que no se debe.
          enum:
            - open
            - overdue
            - paid
            - refunded
            - void
            - covered
          x-extensible-enum: true
        membership_id:
          description: >-
            La membresía de la cuota, en las de tipo `membership` y
            `advance_payment`; `null` en las demás.
          oneOf:
            - $ref: '#/components/schemas/MembershipId'
            - type: 'null'
        credit_grant_id:
          description: El lote de créditos que se cobró con esta cuota; `null` si no hay.
          oneOf:
            - $ref: '#/components/schemas/CreditGrantId'
            - type: 'null'
        advance_payment_fee_id:
          description: >
            En una cuota `covered`, la cuota del pago adelantado que la cubre.
            `null` en las demás, y también en

            una `covered` cuyo pago adelantado ya no existe.
          oneOf:
            - $ref: '#/components/schemas/FeeId'
            - type: 'null'
        created_at:
          $ref: '#/components/schemas/Instant'
    Problem:
      type: object
      description: >
        Un error. Programa contra `code`, que no cambia; `title` y `detail` son
        para mostrarle a una

        persona y pueden cambiar de redacción.
      required:
        - type
        - title
        - status
        - code
        - request_id
      properties:
        type:
          type: string
          format: uri
          description: URL de la página de la documentación de este error.
          examples:
            - https://docs.craqui.com/errors/invalid_api_key
        title:
          type: string
          description: Resumen corto, en español.
          examples:
            - La clave no es válida
        status:
          type: integer
          description: El mismo código HTTP de la respuesta.
          examples:
            - 401
        code:
          type: string
          description: >
            Código estable del error. La lista puede crecer: trata un `code` que
            no conoces como un

            error genérico de su `status`.
          examples:
            - invalid_api_key
        detail:
          type: string
          description: Qué pasó y qué hacer, en español.
          examples:
            - >-
              Revisa que copiaste la clave completa, incluido el prefijo
              (crq_live_ o crq_test_).
        request_id:
          type: string
          pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
          description: >-
            Identificador del pedido. Búscalo en Configuración → Integraciones →
            Actividad de la API.
          examples:
            - req_01hzx8m4k2a7d9q3f5w6y8z0bc
        doc_url:
          type: string
          format: uri
          description: >-
            Igual a `type`, por compatibilidad con clientes que buscan este
            campo.
        required_scope:
          type: string
          description: Solo en `scope_required`. El permiso que le falta a la clave.
          examples:
            - business:read
        errors:
          type: array
          description: Solo en errores de validación. Un elemento por campo con problemas.
          items:
            $ref: '#/components/schemas/FieldError'
    FeeId:
      type: string
      description: Id de una cuota.
      pattern: ^fee_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - fee_01hzx8m4k2a7d9q3f5w6y8z0bc
    Money:
      type: object
      required:
        - amount_cents
        - currency
      properties:
        amount_cents:
          type: integer
          description: El monto multiplicado por 100. `250000` con `UYU` es $ 2.500,00.
          examples:
            - 250000
        currency:
          $ref: '#/components/schemas/CurrencyCode'
    MembershipId:
      type: string
      description: Id de una membresía de un cliente.
      pattern: ^mem_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - mem_01hzx8m4k2a7d9q3f5w6y8z0bc
    CreditGrantId:
      type: string
      description: >-
        Id de un lote de créditos (un pack, una oferta o el período de una
        membresía).
      pattern: ^cgr_[0-7][0-9a-hjkmnp-tv-z]{25}$
      examples:
        - cgr_01hzx8m4k2a7d9q3f5w6y8z0bc
    Instant:
      type: string
      format: date-time
      description: Instante en RFC 3339 con el offset del negocio en ese momento.
      examples:
        - '2026-11-05T19:00:00-03:00'
    FieldError:
      type: object
      required:
        - field
        - code
      properties:
        field:
          type: string
          description: El campo, como lo mandaste (por ejemplo `session_id`).
          examples:
            - session_id
        code:
          type: string
          description: Qué tiene mal el campo.
          examples:
            - invalid_prefix
        detail:
          type: string
          description: Explicación en español.
    CurrencyCode:
      type: string
      description: Moneda ISO 4217, en mayúsculas.
      pattern: ^[A-Z]{3}$
      examples:
        - UYU
  headers:
    RequestId:
      description: Identificador del pedido. Aparece también en el cuerpo de los errores.
      schema:
        type: string
        pattern: ^req_[0-9a-hjkmnp-tv-z]{26}$
    CraquiVersion:
      description: La versión de la API con la que se respondió.
      schema:
        type: string
        pattern: ^\d{4}-\d{2}-\d{2}$
    RateLimit:
      description: >-
        Pedidos que quedan en la ventana actual y segundos hasta que se renueva
        (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";r=97;t=42'
    RateLimitPolicy:
      description: Límite de la clave por ventana (draft IETF httpapi-ratelimit-headers).
      schema:
        type: string
        examples:
          - '"read";q=100;w=60'
    RetryAfter:
      description: Segundos que hay que esperar antes de reintentar.
      schema:
        type: integer
        minimum: 0
  responses:
    BadRequest:
      description: >
        El pedido está mal formado. Códigos posibles: `invalid_api_version`,
        `idempotency_key_required`,

        `validation_failed` (con un elemento de `errors` por parámetro:
        `unknown_parameter`,

        `invalid_prefix`, `invalid_id`, `invalid_date`, `invalid_boolean`,
        `invalid_enum`,

        `invalid_limit`, `duplicate_parameter`, `expand_not_supported`…) e
        `invalid_cursor` (un

        `starting_after` de otra búsqueda: repite la primera página con los
        mismos filtros). El detalle

        de un error nunca repite el valor que mandaste.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Unauthorized:
      description: >
        Falta la clave o no sirve. Códigos posibles: `missing_api_key`,
        `invalid_api_key`,

        `revoked_api_key`, `expired_api_key`, `legacy_api_key`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            revoked:
              value:
                type: https://docs.craqui.com/errors/revoked_api_key
                title: La clave fue revocada
                status: 401
                code: revoked_api_key
                detail: Crea una clave nueva en Configuración → Integraciones.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    Forbidden:
      description: >
        La clave es válida pero no puede hacer esto. Códigos posibles:
        `scope_required`,

        `plan_required`, `api_key_suspended`, `browser_not_allowed`,
        `wrong_vertical`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    Conflict:
      description: >
        Solo con una clave `crq_test_`: tu estudio de prueba no está listo.
        Código

        `sandbox_unavailable`. Restablece tus datos de prueba en Configuración →
        Integraciones y vuelve

        a intentar. Una clave de prueba nunca responde con los datos reales del
        negocio.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
          examples:
            sandbox_unavailable:
              value:
                type: https://docs.craqui.com/errors/sandbox_unavailable
                title: Tu estudio de prueba no está listo
                status: 409
                code: sandbox_unavailable
                detail: >-
                  Restablece tus datos de prueba en Configuración →
                  Integraciones y vuelve a intentar.
                request_id: req_01hzx8m4k2a7d9q3f5w6y8z0bc
    TooManyRequests:
      description: >-
        Se pasó el límite de pedidos por minuto de la clave. Código
        `rate_limited`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
        Retry-After:
          $ref: '#/components/headers/RetryAfter'
        RateLimit:
          $ref: '#/components/headers/RateLimit'
        RateLimit-Policy:
          $ref: '#/components/headers/RateLimitPolicy'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
    InternalError:
      description: >-
        Falló algo de nuestro lado. Código `internal_error`. Reintenta; si
        sigue, escríbenos con el `request_id`.
      headers:
        Request-Id:
          $ref: '#/components/headers/RequestId'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: crq_live_sk_… / crq_live_rk_…
      description: >
        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`.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.