ONDC Retail
  1. Sent by Retail Seller App
ONDC Retail
  • Begin your ONDC journey
  • Glossary - Components and Terms use
  • Pre-requisites
    • Get information about a registered ONDC participant
      POST
    • Onboard on ONDC - step post whitelisting
      POST
  • APIs for Retail Buyer App
    • Sent by Retail Buyer App
      • 01a - Get full catalog from sellers (full refresh) - /search
      • 01b - Get incremental update on catalogue from sellers (incremental refresh) - /search_inc
      • 02 - Inquire about availability and pricing of selected items from catalogue - /select
      • 03 - Initiate an order before confirmation (order in cart) - /init
      • 04 - Finalize order with Seller App (confirmation of order) subject to ACK from Seller App - /confirm
      • 05 - Retrieve the latest status of an order from the Seller App - /status
      • 06 - Get tracking details for an order's fulfillment from the Seller App - /track
      • 07 - Request cancellation of an order or a return request (Buyer initiated) - /cancel
      • 07 - Respond to cancellation initiated by Seller App - ACK to /on_cancel
      • 08 - Initiate updates/changes to an existing order(item quantity, fulfillment updates, or return requests) - /update
      • 08 - Send response to order changes initiated by Seller App - ACK to /on_update
      • 09 - Submit ratings from the buyer's perspective to the network - /rating
      • 10 - IGM - Raise order related issues to Seller App (as raised by customer) - /issue
      • 11 - IGM - Get status of issue previously raised - /issue_status
      • 12 - RSF - Send settlement file to Settlement agency (For prepaid orders) - /settle
      • 13a - RSF - Request reconciliation from receiver (for prepaid orders)
      • 13b - RSF - Respond to recon request by receiver (for prepaid orders)
      • 14 - RSF - Request report from settlement agency - /report
    • Received by Retail Buyer App
      • 01a - Receive full catalogue from Seller App
      • 01b - Receive incremental catalogue refresh from Seller App
      • 02 - Receive response to inquiry about availability and pricing of selected items from catalogue
      • 03 - Receive response to order initiation by Buyer App
      • 04 - Receive response to order confirmation by Buyer App
      • 05a - Receive response to order status request by Buyer App
      • 5b - Receive unsolicitated status update by Seller App
      • 06 - Receive tracking details from Seller App
      • 07a - Receive response on cancellation request from Buyer App
      • 07b - Receive unsolicitated cancellation initiated by Seller App
      • 08a - Receive response to order updates/changes initiated by Buyer App
      • 08b - Receive unsolicitated order updates/changes initiated by Seller App
      • 09 - Send response to ratings sent by Buyer App
      • 10a - IGM - Receive response to issue raised by Buyer App
      • 10b - IGM - Receive response to issue status sent by Seller App
      • 12 - RSF - Receive response to settlement request from Settlement Agency
      • 13a - RSF - Receive response to recon request sent earlier
      • 13b - Receive request for reconciliation by receiver
      • 14 - RSF - Receive response to the report requested
  • APIs for Retail Seller App
    • Sent by Retail Seller App
      • 01a - Received full catalog from sellers (full refresh) - /on_search
        POST
      • 01b - Received incremental update on catalogue from sellers (incremental refresh) - /on_search_inc
        POST
      • 02 - Inquire about availability and pricing of selected items from catalogue - /on_select
        POST
      • 03 - Initiate an order before confirmation (order in cart) - /on_init
        POST
      • 04 - Finalize order with Seller App (confirmation of order) subject to ACK from Seller App - /on_confirm
        POST
      • 05 - Retrieve the latest status of an order from the Seller App - /on_status
        POST
      • 06 - Get tracking details for an order's fulfillment from the Seller App - /on_track
        POST
      • 07 - Request cancellation of an order or a return request (Buyer initiated) - /on_cancel
        POST
      • 07 - Respond to cancellation initiated by Seller App - ACK to /on_cancel
        POST
      • 08 - Initiate updates/changes to an existing order(item quantity, fulfillment updates, or return requests) - /update
        POST
      • 08 - Send response to order changes initiated by Seller App - ACK to /on_update
        POST
      • 09 - Submit ratings from the buyer's perspective to the network - /on_rating
        POST
      • 10 - IGM - Raise order related issues to Seller App (as raised by customer) - /on_issue
        POST
      • 11 - IGM - Get status of issue previously raised - /on_issue_status
        POST
      • 12 - RSF - Send settlement file to Settlement agency (For prepaid orders) - /on_settle
        POST
      • 13a - RSF - Request reconciliation from receiver (for prepaid orders)
        POST
      • 13b - RSF - Respond to recon request by receiver (for prepaid orders)
        POST
      • 14 - RSF - Request report from settlement agency - /on_report
        POST
    • Received by Retail Seller App
      • 07b - Receive unsolicitated cancellation initiated by Seller App
      • 14 - RSF - Receive response to the report requested
      • 13b - Receive request for reconciliation by receiver
      • 13a - RSF - Receive response to recon request sent earlier
      • 12 - RSF - Receive response to settlement request from Settlement Agency
      • 10b - IGM - Receive response to issue status sent by Seller App
      • 10a - IGM - Receive response to issue raised by Buyer App
      • 09 - Send response to ratings sent by Buyer App
      • 08b - Receive unsolicitated order updates/changes initiated by Seller App
      • 08a - Receive response to order updates/changes initiated by Buyer App
      • 07a - Receive response on cancellation request from Buyer App
      • 06 - Receive tracking details from Seller App
      • 5b - Receive unsolicitated status update by Seller App
      • 05a - Receive response to order status request by Buyer App
      • 01a - Receive full catalogue from Seller App
      • 01b - Receive incremental catalogue refresh from Seller App
      • 02 - Receive response to inquiry about availability and pricing of selected items from catalogue
      • 03 - Receive response to order initiation by Buyer App
      • 04 - Receive response to order confirmation by Buyer App
  1. Sent by Retail Seller App

02 - Inquire about availability and pricing of selected items from catalogue - /on_select

Developing
POST
/on_select
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/on_select' \
--header 'Content-Type: application/json' \
--data-raw '{
  "context": {
    "domain": "ONDC:RET11",
    "country": "IND",
    "city": "std:0124",
    "core_version": "1.2.5",
    "action": "on_select",
    "transaction_id": "{{transaction_id}}",
    "message_id": "{{message_id}}",
    "timestamp": "{{timestamp}}",
    "bap_uri": "{{bap_uri}}",
    "bap_id": "{{bap_id}}",
    "bpp_uri": "{{bpp_uri}}",
    "bpp_id": "{{bpp_id}}",
    "ttl": "PT30S"
  },
  "message": {
    "order": {
      "fulfillments": [
        {
          "id": "f0adf3c0-1ce7-492a-a983-afada6010878",
          "type": "Delivery",
          "@ondc/org/provider_name": "Pramaan Store 1",
          "tracking": true,
          "@ondc/org/category": "Immediate Delivery",
          "@ondc/org/TAT": "PT24H",
          "state": {
            "descriptor": {
              "code": "Serviceable"
            }
          },
          "end": {
            "time": {
              "range": {
                "start": "2025-05-23T08:34:45.691Z",
                "end": "2025-05-23T09:34:45.691Z"
              }
            }
          }
        },
        {
          "id": "b5634175-9158-452c-a034-19941d164194",
          "type": "Delivery",
          "@ondc/org/provider_name": "Pramaan Store 1",
          "tracking": true,
          "@ondc/org/category": "Immediate Delivery",
          "@ondc/org/TAT": "PT24H",
          "state": {
            "descriptor": {
              "code": "Serviceable"
            }
          },
          "end": {
            "time": {
              "range": {
                "start": "2025-05-23T09:34:45.691Z",
                "end": "2025-05-23T10:34:45.691Z"
              }
            }
          }
        },
        {
          "id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
          "type": "Self-Pickup",
          "@ondc/org/provider_name": "Pramaan Store 1",
          "tracking": false,
          "@ondc/org/category": "Takeaway",
          "@ondc/org/TAT": "PT24H",
          "state": {
            "descriptor": {
              "code": "Serviceable"
            }
          }
        },
        {
          "id": "99678890-4935-4407-a4e8-d65691220789",
          "type": "Buyer-Delivery",
          "@ondc/org/provider_name": "Pramaan Store 1",
          "tracking": false,
          "@ondc/org/category": "Immediate Delivery",
          "@ondc/org/TAT": "PT15M",
          "state": {
            "descriptor": {
              "code": "Serviceable"
            }
          },
          "tags": [
            {
              "code": "order_details",
              "list": [
                {
                  "code": "weight_unit",
                  "value": "kilogram"
                },
                {
                  "code": "weight_value",
                  "value": "3.0"
                },
                {
                  "code": "dim_unit",
                  "value": "centimeter"
                },
                {
                  "code": "length",
                  "value": "1.0"
                },
                {
                  "code": "breadth",
                  "value": "1.0"
                },
                {
                  "code": "height",
                  "value": "1.0"
                }
              ]
            }
          ]
        }
      ],
      "items": [
        {
          "id": "id_ancc5_0_0",
          "quantity": {
            "count": 2
          },
          "parent_item_id": "P3121",
          "tags": [
            {
              "code": "type",
              "list": [
                {
                  "code": "type",
                  "value": "item"
                }
              ]
            }
          ],
          "location_id": "SSL1",
          "fulfillment_id": [
            "f0adf3c0-1ce7-492a-a983-afada6010878",
            "b5634175-9158-452c-a034-19941d164194"
          ]
        },
        {
          "id": "id_5yzai_2_0",
          "quantity": {
            "count": 2
          },
          "parent_item_id": "P3121",
          "tags": [
            {
              "code": "type",
              "list": [
                {
                  "code": "type",
                  "value": "customization"
                }
              ]
            },
            {
              "code": "parent",
              "list": [
                {
                  "code": "id",
                  "value": "CG11"
                },
                {
                  "code": "default",
                  "value": "yes"
                }
              ]
            }
          ],
          "fulfillment_id": [
            "f0adf3c0-1ce7-492a-a983-afada6010878",
            "b5634175-9158-452c-a034-19941d164194"
          ]
        }
      ],
      "quote": {
        "price": {
          "currency": "INR",
          "value": "895.00"
        },
        "breakup": [
          {
            "@ondc/org/item_id": "id_ancc5_0_0",
            "title": "Farmhouse Pizza",
            "@ondc/org/item_quantity": {
              "count": 2
            },
            "@ondc/org/title_type": "item",
            "price": {
              "currency": "INR",
              "value": "530.00"
            },
            "item": {
              "quantity": {
                "available": {
                  "count": "99"
                },
                "maximum": {
                  "count": "99"
                }
              },
              "price": {
                "currency": "INR",
                "value": "265"
              },
              "parent_item_id": "P3121",
              "tags": [
                {
                  "code": "veg_nonveg",
                  "list": [
                    {
                      "code": "veg",
                      "value": "yes"
                    }
                  ]
                },
                {
                  "code": "type",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "custom_group",
                  "list": [
                    {
                      "code": "id",
                      "value": "CG11"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.50"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "id_5yzai_2_0",
            "title": "100% Wheat Thin Crust",
            "@ondc/org/item_quantity": {
              "count": 2
            },
            "@ondc/org/title_type": "item",
            "price": {
              "currency": "INR",
              "value": "0.00"
            },
            "item": {
              "quantity": {
                "available": {
                  "count": "99"
                },
                "maximum": {
                  "count": "99"
                }
              },
              "price": {
                "currency": "INR",
                "value": "0"
              },
              "parent_item_id": "P3121",
              "tags": [
                {
                  "code": "veg_nonveg",
                  "list": [
                    {
                      "code": "veg",
                      "value": "yes"
                    }
                  ]
                },
                {
                  "code": "type",
                  "list": [
                    {
                      "code": "type",
                      "value": "customization"
                    }
                  ]
                },
                {
                  "code": "parent",
                  "list": [
                    {
                      "code": "id",
                      "value": "CG11"
                    },
                    {
                      "code": "default",
                      "value": "yes"
                    }
                  ]
                },
                {
                  "code": "child",
                  "list": [
                    {
                      "code": "id",
                      "value": "CG21"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Delivery charges",
            "@ondc/org/title_type": "delivery",
            "price": {
              "currency": "INR",
              "value": "40"
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "fulfillment"
                    },
                    {
                      "code": "subtype",
                      "value": "delivery"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.50"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.75"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "f0adf3c0-1ce7-492a-a983-afada6010878",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Delivery charges",
            "@ondc/org/title_type": "delivery",
            "price": {
              "currency": "INR",
              "value": "0"
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Packing charges",
            "@ondc/org/title_type": "packing",
            "price": {
              "currency": "INR",
              "value": "25"
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.50"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "60e58daa-9c69-445a-8a31-ae3ef14913ab",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.75"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Delivery charges",
            "@ondc/org/title_type": "delivery",
            "price": {
              "currency": "INR",
              "value": "0"
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Packing charges",
            "@ondc/org/title_type": "packing",
            "price": {
              "currency": "INR",
              "value": "25"
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Tax",
            "@ondc/org/title_type": "tax",
            "price": {
              "currency": "INR",
              "value": "5"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    },
                    {
                      "code": "subtype",
                      "value": "misc"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "1"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.50"
                    }
                  ]
                }
              ]
            }
          },
          {
            "@ondc/org/item_id": "99678890-4935-4407-a4e8-d65691220789",
            "title": "Convenience Fee",
            "@ondc/org/title_type": "misc",
            "price": {
              "currency": "INR",
              "value": "40"
            },
            "item": {
              "tags": [
                {
                  "code": "quote",
                  "list": [
                    {
                      "code": "type",
                      "value": "item"
                    }
                  ]
                },
                {
                  "code": "np_fees",
                  "list": [
                    {
                      "code": "id",
                      "value": "2"
                    },
                    {
                      "code": "channel_margin_type",
                      "value": "percent"
                    },
                    {
                      "code": "channel_margin_value",
                      "value": "0.75"
                    }
                  ]
                }
              ]
            }
          }
        ],
        "ttl": "PT6H"
      },
      "provider": {
        "id": "pramaan_provider_1",
        "locations": [
          {
            "id": "SSL1"
          }
        ]
      }
    }
  }
}'
Response Response Example
{}

Request

Body Params application/json

Examples

Responses

🟢200Success
application/json
Body

Modified at 2025-06-09 13:16:47
Previous
01b - Received incremental update on catalogue from sellers (incremental refresh) - /on_search_inc
Next
03 - Initiate an order before confirmation (order in cart) - /on_init
Built with