> ## Documentation Index > Fetch the complete documentation index at: https://docs.compago.com/llms.txt > Use this file to discover all available pages before exploring further. # List payments > Every payment your organization has taken, newest first. Scoped to your own businesses: payments merely funded by one of your promotions are not included. ## OpenAPI ````yaml GET /developer/v1/payment openapi: 3.1.0 info: title: Compago API version: 1.0.0 description: >- Public and private API endpoints for Compago's payment infrastructure. This specification currently includes endpoints for one-time payments. More endpoints will be added as the platform evolves. servers: - url: https://demo-api-harmony.compago.com/api - url: https://api-harmony.compago.com/api security: [] tags: - name: OneTimePayment description: Endpoints for creating and processing one-time payment links - name: PaymentMethod description: >- Endpoints for saving cards, charging saved payment methods, holding and capturing funds, and processing refunds - name: PaymentIntent description: >- Endpoints for creating and managing card-present payment intents for POS terminal integrations - name: Payments description: Read the payments your organization has taken - name: Subscriptions description: Read and manage recurring billing agreements - name: PaymentLinks description: Create, edit and retire hosted checkout links - name: Products description: Manage the catalogue behind product-based payment links - name: Promotions description: Read the promotions your organization funds or benefits from - name: Salespeople description: Read the point-of-sale operators in your organization - name: Organization description: Read your organization profile and its members - name: SavedCards description: Read saved payment methods and their payments paths: /developer/v1/payment: get: tags: - Payments summary: List payments description: >- Every payment your organization has taken, newest first. Scoped to your own businesses: payments merely funded by one of your promotions are not included. operationId: listPublicPayments parameters: - name: limit in: query schema: type: integer minimum: 1 maximum: 100 default: 20 description: Rows per page. Values above 100 are rejected. - name: cursor in: query schema: type: string description: >- Opaque cursor from a previous response's `pagination.nextCursor`. Omit for the first page. - name: status in: query schema: oneOf: - type: string enum: - CONFIRMED - CANCELLED - REFUNDED - HELD - HOLD_RELEASED - HOLD_EXPIRED - type: array items: type: string enum: - CONFIRMED - CANCELLED - REFUNDED - HELD - HOLD_RELEASED - HOLD_EXPIRED description: Filter by status. Repeat for several. - name: type in: query schema: type: string enum: - CARD_PRESENT - CARD_NOT_PRESENT description: Filter by capture type. - name: operationCode in: query schema: type: integer description: Exact operation code. - name: paymentLinkId in: query schema: type: string format: uuid description: Only payments taken through this link. - name: subscriptionId in: query schema: type: string format: uuid description: Only payments billed by this subscription. - name: oneTimePaymentId in: query schema: type: string format: uuid description: Only payments for this one-time payment. - name: paymentMethodId in: query schema: type: string format: uuid description: Only payments charged to this saved card. - name: createdAtFrom in: query schema: type: string format: date-time description: Inclusive lower bound. - name: createdAtTo in: query schema: type: string format: date-time description: Inclusive upper bound. responses: '200': description: Success. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/PublicPayment' pagination: $ref: '#/components/schemas/PublicPagination' required: - data - pagination '400': description: Invalid request. A query parameter failed validation. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Unauthorized. The `x-api-key` header is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- Forbidden. The key is not bound to an organization, or the organization is not a merchant. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit exceeded. See the `Retry-After` and `X-RateLimit-*` headers. content: application/json: schema: $ref: '#/components/schemas/PublicError' security: - ApiKeyAuth: [] components: schemas: PublicPayment: type: object properties: id: type: string format: uuid operationCode: type: integer description: The reference printed on receipts and shown in the dashboard. status: type: string enum: - CONFIRMED - CANCELLED - REFUNDED - HELD - HOLD_RELEASED - HOLD_EXPIRED type: type: string description: CARD_PRESENT or CARD_NOT_PRESENT. amount: type: number currency: type: string fee: type: - number - 'null' description: The percentage fee charged to this merchant on this payment. terms: type: integer description: Installments agreed. 1 for a single payment. paidTerms: type: integer description: Installments already settled to the merchant. periodicity: type: - string - 'null' financingMethod: type: - string - 'null' source: type: - string - 'null' description: Where the payment originated, e.g. SHAREPAY_PAYMENT_LINK. createdAt: type: string format: date-time refundedAt: type: - string - 'null' format: date-time heldAmount: type: - number - 'null' description: >- What the bank authorized. Differs from `amount` after a partial capture. heldAt: type: - string - 'null' format: date-time capturedAt: type: - string - 'null' format: date-time holdReleasedAt: type: - string - 'null' format: date-time holdExpiresAt: type: - string - 'null' format: date-time description: When the authorization lapses. holdExpired: type: boolean description: Only meaningful while the payment is HELD. holdDaysRemaining: type: - integer - 'null' description: Only set while the payment is HELD. card: oneOf: - $ref: '#/components/schemas/PublicCard' - type: 'null' customer: oneOf: - $ref: '#/components/schemas/PublicCustomer' - type: 'null' paymentLinkId: type: - string - 'null' format: uuid paymentIntentId: type: - string - 'null' format: uuid oneTimePaymentId: type: - string - 'null' format: uuid paymentMethodId: type: - string - 'null' format: uuid subscriptionId: type: - string - 'null' format: uuid required: - id - status - amount - currency - createdAt PublicPagination: type: object properties: limit: type: integer description: Rows requested for this page. hasMore: type: boolean description: Whether another page exists. nextCursor: type: - string - 'null' description: Pass as `?cursor=` to fetch the next page. Null on the last page. required: - limit - hasMore - nextCursor PublicError: type: object properties: message: type: string description: Human-readable description. code: type: string description: Stable machine-readable code. Branch on this, not on `message`. required: - message PublicCard: type: object properties: lastFourDigits: type: - string - 'null' network: type: - string - 'null' fundingSource: type: - string - 'null' issuingBank: type: - string - 'null' description: >- The card, masked. The full number and the stored token are never returned. PublicCustomer: type: object properties: firstName: type: - string - 'null' lastName: type: - string - 'null' email: type: - string - 'null' phoneNumber: type: - string - 'null' securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````