> ## Documentation Index > Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List Payments > Returns a list of payments. The payments are returned in reverse chronological order (most recent first). Use the `count` and `skip` parameters to paginate through results. ## OpenAPI ````yaml /openapi/core.json get /payments openapi: 3.1.0 info: title: Razorpay Core Resources API description: >- The Razorpay Core Resources API provides endpoints for managing Orders, Payments, Refunds, and Settlements. Use HTTP Basic Auth with your Key ID as the username and Key Secret as the password. version: 1.0.0 contact: name: Razorpay Support url: https://razorpay.com/support servers: - url: https://api.razorpay.com/v1 description: Razorpay Production API security: - basicAuth: [] tags: - name: Orders description: >- Orders represent payment intents. Create an order before accepting a payment from a customer. - name: Payments description: >- Payments represent individual payment transactions. Fetch, list, and capture payments. - name: Refunds description: >- Refunds represent the reversal of a payment back to the customer. Initiate full or partial refunds against captured payments. - name: Settlements description: >- Settlements represent the transfer of funds collected from payments to your registered bank account. paths: /payments: get: tags: - Payments summary: List Payments description: >- Returns a list of payments. The payments are returned in reverse chronological order (most recent first). Use the `count` and `skip` parameters to paginate through results. operationId: listPayments parameters: - $ref: '#/components/parameters/CountParam' - $ref: '#/components/parameters/SkipParam' - $ref: '#/components/parameters/FromParam' - $ref: '#/components/parameters/ToParam' responses: '200': description: A list of payments. content: application/json: schema: $ref: '#/components/schemas/PaymentListResponse' example: entity: collection count: 2 items: - id: pay_DJkTfWoJ5ZFPce entity: payment amount: 50000 currency: INR status: captured order_id: order_IluGWxBm9U8zJ8 method: upi captured: true description: 'Payment for order #1001' email: john.doe@example.com contact: '+919876543210' created_at: 1595491108 - id: pay_EKmTfXpK6AGQdf entity: payment amount: 100000 currency: INR status: authorized order_id: order_IluGWxCn0V9aK9 method: card captured: false description: 'Payment for order #1002' email: jane.doe@example.com contact: '+919876543211' created_at: 1595491208 '401': $ref: '#/components/responses/UnauthorizedError' components: parameters: CountParam: name: count in: query description: The number of items to return per page. Maximum value is 100. required: false schema: type: integer maximum: 100 default: 10 example: 25 SkipParam: name: skip in: query description: >- The number of items to skip from the beginning of the list, used for pagination. required: false schema: type: integer default: 0 example: 10 FromParam: name: from in: query description: >- Unix timestamp (in seconds). Only items created on or after this time are returned. required: false schema: type: integer example: 1609459200 ToParam: name: to in: query description: >- Unix timestamp (in seconds). Only items created on or before this time are returned. required: false schema: type: integer example: 1640995200 schemas: PaymentListResponse: type: object description: A paginated list of payment objects. properties: entity: type: string description: Entity type, always `collection` for list responses. example: collection count: type: integer description: The number of payments returned in this response. example: 10 items: type: array description: An array of payment objects. items: $ref: '#/components/schemas/Payment' Payment: type: object description: A Razorpay Payment object representing a payment transaction. properties: id: type: string description: Unique identifier for the payment. example: pay_DJkTfWoJ5ZFPce entity: type: string description: Entity type, always `payment` for payment objects. example: payment amount: type: integer description: >- The payment amount in the smallest currency sub-unit (e.g., paise for INR). example: 50000 currency: type: string description: The ISO 4217 currency code for the payment. example: INR status: type: string description: The current status of the payment. enum: - created - authorized - captured - refunded - failed example: captured order_id: type: string description: The unique identifier of the order associated with this payment. example: order_IluGWxBm9U8zJ8 method: type: string description: The payment method used for this transaction. enum: - card - netbanking - wallet - upi - emi example: upi captured: type: boolean description: >- Indicates whether the payment has been captured. `true` if the payment is captured. example: true description: type: string description: A brief description of the payment. example: 'Payment for order #1001' email: type: string description: The email address of the customer who made the payment. example: john.doe@example.com contact: type: string description: The phone number of the customer who made the payment. example: '+919876543210' created_at: type: integer description: Unix timestamp (in seconds) at which the payment was created. example: 1595491108 ErrorResponse: type: object description: An error response returned by the API. properties: error: type: object properties: code: type: string description: A machine-readable error code. example: BAD_REQUEST_ERROR description: type: string description: A human-readable description of the error. example: The amount must be at least 100 paise. source: type: string description: The source of the error (e.g., `business` or `customer`). example: business step: type: string description: The step at which the error occurred. example: payment_initiation reason: type: string description: A brief reason for the error. example: input_validation_failed metadata: type: object description: Additional metadata about the error. additionalProperties: true responses: UnauthorizedError: description: Authentication credentials are missing or invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: basicAuth: type: http scheme: basic description: Use your Razorpay Key ID as the username and Key Secret as the password. ````