> ## 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 Orders > Returns a list of orders. The orders 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 /orders 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: /orders: get: tags: - Orders summary: List Orders description: >- Returns a list of orders. The orders are returned in reverse chronological order (most recent first). Use the `count` and `skip` parameters to paginate through results. operationId: listOrders parameters: - $ref: '#/components/parameters/CountParam' - $ref: '#/components/parameters/SkipParam' - $ref: '#/components/parameters/FromParam' - $ref: '#/components/parameters/ToParam' - name: authorized in: query description: >- Filter orders by their authorization status. Set to `true` to return only orders that have been authorized. required: false schema: type: boolean example: true - name: receipt in: query description: Filter orders by a specific receipt number. required: false schema: type: string example: receipt_1001 responses: '200': description: A list of orders. content: application/json: schema: $ref: '#/components/schemas/OrderListResponse' example: entity: collection count: 2 items: - id: order_IluGWxBm9U8zJ8 entity: order amount: 50000 amount_paid: 50000 amount_due: 0 currency: INR receipt: receipt_1001 status: paid attempts: 1 notes: customer_name: John Doe created_at: 1595491008 - id: order_IluGWxCn0V9aK9 entity: order amount: 100000 amount_paid: 0 amount_due: 100000 currency: INR receipt: receipt_1002 status: created attempts: 0 notes: {} created_at: 1595491108 '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: OrderListResponse: type: object description: A paginated list of order objects. properties: entity: type: string description: Entity type, always `collection` for list responses. example: collection count: type: integer description: The number of orders returned in this response. example: 10 items: type: array description: An array of order objects. items: $ref: '#/components/schemas/Order' Order: type: object description: A Razorpay Order object representing a payment order. properties: id: type: string description: Unique identifier for the order. example: order_IluGWxBm9U8zJ8 entity: type: string description: Entity type, always `order` for order objects. example: order amount: type: integer description: >- The order amount in the smallest currency sub-unit (e.g., paise for INR). For example, 50000 represents ₹500. example: 50000 amount_paid: type: integer description: >- The amount paid against the order, in the smallest currency sub-unit. example: 0 amount_due: type: integer description: >- The remaining amount to be paid against the order, in the smallest currency sub-unit. example: 50000 currency: type: string description: The ISO 4217 currency code for the order. example: INR receipt: type: string description: >- A unique receipt number provided by the merchant for internal reference. example: receipt_1001 status: type: string description: The current status of the order. enum: - created - attempted - paid example: created attempts: type: integer description: The number of payment attempts made against this order. example: 0 notes: type: object description: >- A key-value store of custom metadata to attach to the order. Values must be strings. additionalProperties: type: string example: customer_name: John Doe order_type: premium created_at: type: integer description: Unix timestamp (in seconds) at which the order was created. example: 1595491008 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. ````