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.

GET /orders

List Orders

cURL

curl --request GET \
  --url https://api.razorpay.com/v1/orders \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "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
    }
  ]
}

Authorizations

Authorization · string · header · required

Use your Razorpay Key ID as the username and Key Secret as the password.

Query Parameters

count · integer · default: 10

The number of items to return per page. Maximum value is 100.

Required range: x <= 100

Example:

25

skip · integer · default: 0

The number of items to skip from the beginning of the list, used for pagination.

Example:

10

from · integer

Unix timestamp (in seconds). Only items created on or after this time are returned.

Example:

1609459200

to · integer

Unix timestamp (in seconds). Only items created on or before this time are returned.

Example:

1640995200

authorized · boolean

Filter orders by their authorization status. Set to true to return only orders that have been authorized.

Example:

true

receipt · string

Filter orders by a specific receipt number.

Example:

"receipt_1001"

Response

200

application/json

A list of orders.

A paginated list of order objects.

entity · string

Entity type, always collection for list responses.

Example:

"collection"

count · integer

The number of orders returned in this response.

Example:

10

items · object[]

An array of order objects.

Show child attributes