Api

Items

Items

Create and manage items using Razorpay APIs.

Items are products or services that you bill customers for by adding them to an invoice. You can create an item using APIs. When an item is created, it will appear on the list of items in the Dashboard.

Handy Tips
If your business requires you to create custom items, you can create pre-defined item templates beforehand and use these later as line items.

You can try out our APIs on the Razorpay Postman Public Workspace.

Run in Postman

Items Entity🔗

Following is a list of attributes of an item entity and their explanation:

id
string Unique identifier of the item.
name
string Name of the item.
description
string A text description about the item.
amount
integer The price of the item in the lowest unit of currency.
currency
string The currency in which the amount should be charged. Select from the list of currencies.
active
boolean Indicates the status of the item. Possible values:
  • true - Item is in active state.
  • false - Item is in inactive state. By default, the item is in active state.

Create an Item🔗

The following endpoint helps you create an item.

/items

Request Parameters🔗

name mandatory
string Name of the item.
description optional
string A brief description about the item.
amount mandatory
integer The price of the item in the lowest unit of currency.
currency mandatory
string The currency in which the amount should be charged. We support international currencies.

Once an item is created, it will appear on the list of created item and also in the drop-down menu at the time of invoice creation. You can also edit the details of a created item by going to the list of items and clicking on a specific item.

Fetch an Item🔗

The following endpoint helps you to fetch the details of a specific item using the Item_id.

/items/:id

Path Parameter🔗

id mandatory
string The unique identifier of the item whose details are to be fetched.

The response for getting an item id: item_7Oxp4hmm6T4SCn is shown:

Fetch Multiple Items🔗

The following endpoint helps to fetch the details of all the items created till date.

/items

Query Parameters🔗

from
integer Timestamp, in seconds, from when items are to be fetched.
to
integer Timestamp, in seconds, till when items are to be fetched.
count
integer Number of items to be fetched.
Default value is 10. Maximum value is 100. This can be used for pagination, in combination with the skip parameter.
skip
integer Number of records to be skipped while fetching the items.
active
integer Fetches number of active or inactive items. The value is 1 for active items and 0 for inactive items.

Update an Item🔗

The following endpoint helps to update the details of an item.

/item/:id

Path Parameter🔗

id mandatory
string The unique identifer of the item whose details are to be updated.

Request Parameters🔗

name optional
string Name of the item.
description optional
string A brief description about the item.
amount optional
integer The price of the item in the lowest unit of currency.
currency optional
string The currency in which the amount should be charged. We support international currencies.
active optional
boolean Indicates the status of the item. Possible values:
  • true - Item is in active state.
  • false - Item is in inactive state. By default, the item is in active state.

The response for getting an item id: item_7Oy8OMV6BdEAac is shown:

Delete an Item🔗

The following endpoint helps you to delete an item.

/items/:id

Path Parameter🔗

id mandatory
string The unique identifier of the item that must be deleted.

The response for deleting an item id: item_7Oy8OMV6BdEAac is shown:

×

ON THIS PAGE