Skip to main content
GET
/
orders
/
{order_id}
/
extended
Get Order Extended
curl --request GET \
  --url https://sandbox.cashfree.com/pg/orders/{order_id}/extended \
  --header 'x-api-version: <x-api-version>' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>'
{
  "cf_order_id": "2149460581",
  "order_id": "order_3242Tq4Edj9CC5RDcMeobmJOWOBJij",
  "order_amount": 22,
  "order_currency": "INR",
  "created_at": "2023-08-11T18:02:46+05:30",
  "charges": {
    "shipping_charges": 5,
    "cod_handling_charges": 10
  },
  "customer_details": {
    "customer_id": "409128494",
    "customer_name": "Aditya Keshri",
    "customer_email": "pmlpayme@ntsas.com",
    "customer_phone": "9876543210",
    "customer_uid": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10"
  },
  "shipping_address": {
    "name": "Saurav Singh",
    "address_line_one": "MK Building",
    "address_line_two": "Test Address",
    "country": "India",
    "country_code": "IN",
    "state": "Karnataka",
    "state_code": "KA",
    "city": "Bangalore",
    "pin_code": "560034",
    "phone": "+91 1118911189",
    "email": "test@cashfree.com"
  },
  "billing_address": {
    "name": "Saurav Singh",
    "address_line_one": "MK Building",
    "address_line_two": "Test Address",
    "country": "India",
    "country_code": "IN",
    "state": "Karnataka",
    "state_code": "KA",
    "city": "Bangalore",
    "pin_code": "560034",
    "phone": "+91 1118911189",
    "email": "test@cashfree.com"
  },
  "cart": {
    "name": "test",
    "items": [
      {
        "item_id": "26",
        "item_name": "Sample Product",
        "item_description": "item-description",
        "item_tags": [
          "1",
          "2"
        ],
        "item_details_url": "http://cashfree.com",
        "item_image_url": "http://cashfree.com",
        "item_original_unit_price": "1",
        "item_discounted_unit_price": "1",
        "item_quantity": 1,
        "item_currency": "INR"
      }
    ]
  },
  "offer": {
    "offer_id": "d2b430fb-1afe-455a-af31-66d00377b29a",
    "offer_status": "active",
    "offer_meta": {
      "offer_title": "some title",
      "offer_description": "some offer description"
    }
  }
}
Run in Postman: You can also try this API in our Postman Collection.
This API allows you to retrieve order data for the current and previous financial years. To access data older than this period, log in to the Merchant Dashboard

Authorizations

ā€‹
x-client-id
string
header
required

Client app ID. You can find your app id in the Merchant Dashboard.

ā€‹
x-client-secret
string
header
required

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

ā€‹
x-api-version
string
default:2025-01-01
required

API version to be used.

ā€‹
x-request-id
string

Request ID for the API call. Can be used to resolve tech issues. Communicate this in your tech related queries to Cashfree.

ā€‹
x-idempotency-key
string<UUID>

An idempotency key is a unique identifier you include with your API call. If the request fails or times out, you can safely retry it using the same key to avoid duplicate actions.

Path Parameters

ā€‹
order_id
string
required

The ID which uniquely identifies your order.

Response

Success response for fetching the order related data like address,cart,offers,customer details etc using the Cashfree's order_id.

ā€‹
cf_order_id
string

unique id generated by cashfree for your order.

ā€‹
order_id
string

order_id sent during the api request.

ā€‹
order_amount
number
ā€‹
order_currency
string

Currency of the order. Example INR.

ā€‹
created_at
string

When the order was created at cashfree's server.

Example:

"2022-08-16T14:45:38+05:30"

ā€‹
charges
ChargesEntity Ā· object

Charges accociated with the order.

Example:
{
  "shipping_charges": 5,
  "cod_handling_charges": 10
}
ā€‹
customer_details
CustomerDetails Ā· object

Recent Customer details associated with the order.

Example:
{
  "customer_id": "7112AAA812234",
  "customer_email": "john@cashfree.com",
  "customer_phone": "9908734801",
  "customer_name": "John Doe",
  "customer_uid": "54deabb4-ba45-4a60-9e6a-9c016fe7ab10"
}
ā€‹
shipping_address
AddressDetails Ā· object

Address associated with the customer.

Example:
{
  "name": "Aditya Keshri",
  "address_line_one": "MK Building",
  "address_line_two": "Test Address",
  "country": "India",
  "country_code": "IN",
  "state": "Karnataka",
  "state_code": "KA",
  "city": "Bangalore",
  "pin_code": "560034",
  "phone": "+91 1118911189",
  "email": "test@cashfree.com"
}
ā€‹
billing_address
AddressDetails Ā· object

Address associated with the customer.

Example:
{
  "name": "Aditya Keshri",
  "address_line_one": "MK Building",
  "address_line_two": "Test Address",
  "country": "India",
  "country_code": "IN",
  "state": "Karnataka",
  "state_code": "KA",
  "city": "Bangalore",
  "pin_code": "560034",
  "phone": "+91 1118911189",
  "email": "test@cashfree.com"
}
ā€‹
cart
CartDetails Ā· object

The cart details that are necessary like shipping address, billing address and more.

ā€‹
offer
OfferEntity Ā· object

Details of the offer which got applied to the paid order.