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

# List all payments (all hubs)

> Return the authenticated contact's payments across all hubs, one page
at a time.

Queries by contact_id only -- never by team_id. Cursor-paginated
(``page[after]``/``page[size]``, house pattern -- see
``app.infrastructure.pagination``), same as ``list_saved_items``:
``meta.total`` is a real count, independent of the page.



## OpenAPI

````yaml /openapi/mio-openapi.json get /me/payments
openapi: 3.1.0
info:
  description: >-
    Production API reference for Membership.io. Use the authored guides for
    workflows and the generated endpoint pages for exact parameters and schemas.
  title: Membership.io API
  version: 0.1.0
servers:
  - description: Production
    url: https://api.member.dev
security:
  - bearerAuth: []
paths:
  /me/payments:
    get:
      tags:
        - checkout-me
      summary: List all payments (all hubs)
      description: |-
        Return the authenticated contact's payments across all hubs, one page
        at a time.

        Queries by contact_id only -- never by team_id. Cursor-paginated
        (``page[after]``/``page[size]``, house pattern -- see
        ``app.infrastructure.pagination``), same as ``list_saved_items``:
        ``meta.total`` is a real count, independent of the page.
      operationId: checkout_me.get_checkout_me_get_me_payments
      parameters:
        - description: Cursor — ID of the last item on the previous page.
          in: query
          name: page[after]
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Cursor — ID of the last item on the previous page.
            title: Page[After]
        - in: query
          name: page[size]
          required: false
          schema:
            default: 20
            maximum: 100
            minimum: 1
            title: Page[Size]
            type: integer
      responses:
        '200':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/MemberPaymentListResponse'
          description: Successful Response
        '400':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Validation error
        '401':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Not authenticated
        '403':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Forbidden
        '404':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Resource not found
        '409':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Conflict (duplicate)
        '422':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Unprocessable entity
        '503':
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/JsonApiErrorResponse'
          description: Stripe unavailable
      security:
        - HTTPBearer: []
components:
  schemas:
    MemberPaymentListResponse:
      additionalProperties: false
      properties:
        data:
          items:
            $ref: '#/components/schemas/MemberPaymentResource'
          title: Data
          type: array
        meta:
          $ref: '#/components/schemas/MemberPaymentListMeta'
      required:
        - data
        - meta
      title: MemberPaymentListResponse
      type: object
    JsonApiErrorResponse:
      description: Error JSON:API response.
      properties:
        errors:
          items:
            $ref: '#/components/schemas/JsonApiError'
          title: Errors
          type: array
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
      required:
        - errors
      title: JsonApiErrorResponse
      type: object
    MemberPaymentResource:
      additionalProperties: false
      properties:
        attributes:
          $ref: '#/components/schemas/MemberPaymentAttributes'
        id:
          title: Id
          type: string
        type:
          const: payments
          default: payments
          title: Type
          type: string
      required:
        - id
        - attributes
      title: MemberPaymentResource
      type: object
    MemberPaymentListMeta:
      additionalProperties: false
      description: |-
        ``build_page_meta()``'s page block plus a real total count.

        ``total`` is a genuine ``COUNT(*)`` over every payment matching the
        caller's scope -- NOT ``len(data)`` -- so it stays correct once the
        result spans more than one page.
      properties:
        page:
          $ref: '#/components/schemas/MemberPaymentPageMeta'
        total:
          title: Total
          type: integer
      required:
        - total
        - page
      title: MemberPaymentListMeta
      type: object
    JsonApiError:
      properties:
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
        detail:
          anyOf:
            - type: string
            - type: 'null'
          title: Detail
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Meta
        source:
          anyOf:
            - additionalProperties:
                type: string
              type: object
            - type: 'null'
          title: Source
        status:
          title: Status
          type: string
        title:
          title: Title
          type: string
      required:
        - status
        - title
      title: JsonApiError
      type: object
    MemberPaymentAttributes:
      additionalProperties: false
      properties:
        amount:
          title: Amount
          type: integer
        created_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Created At
        currency:
          title: Currency
          type: string
        external_charge_id:
          anyOf:
            - type: string
            - type: 'null'
          title: External Charge Id
        external_hosted_invoice_url:
          anyOf:
            - type: string
            - type: 'null'
          title: External Hosted Invoice Url
        order_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Order Id
        period:
          anyOf:
            - type: string
            - type: 'null'
          title: Period
        plan_description:
          anyOf:
            - type: string
            - type: 'null'
          title: Plan Description
        plan_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Plan Name
        price_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Price Name
        price_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Price Type
        refunded_at:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Refunded At
        status:
          title: Status
          type: string
      required:
        - amount
        - currency
        - status
        - external_hosted_invoice_url
        - plan_name
        - price_name
        - plan_description
        - price_type
        - period
      title: MemberPaymentAttributes
      type: object
    MemberPaymentPageMeta:
      additionalProperties: false
      description: |-
        Mirrors ``build_page_meta()``'s ``meta["page"]`` block (see
        ``app.infrastructure.pagination``) -- the house cursor-pagination shape.
      properties:
        has_more:
          title: Has More
          type: boolean
        next_cursor:
          anyOf:
            - type: string
            - type: 'null'
          title: Next Cursor
        size:
          title: Size
          type: integer
      required:
        - size
        - has_more
      title: MemberPaymentPageMeta
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT or mio_sk API key
      description: >-
        Send platform JWTs, contact JWTs, or team API keys as `Authorization:
        Bearer <token>`.
      scheme: bearer
      type: http
    HTTPBearer:
      scheme: bearer
      type: http

````

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