How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Zoho Inventory

Zoho Inventory Sales Returns API

SalesReturns Module

Documentation Provider Profile APIs.io OpenAPI GitHub

Zoho Inventory Sales Returns API is one of 37 APIs that Zoho Inventory publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include Sales Returns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 1 JSON Schema.

This API exposes 7 operations across 4 paths, and defines 67 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://www.zohoapis.com/inventory/v1.

7 operations 4 paths 67 schemas 2 DELETE2 GET2 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://www.zohoapis.com/inventory/v1
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Zoho Inventory Sales Returns API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (Zoho_Auth) using the implicit flow, exposing 6 scopes.

Paths & Operations 7

Across 4 paths, the API surfaces 7 operations — 2 DELETE, 2 GET, 2 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Sales Returns 7

SalesReturns Module

POST
/salesreturns
Create a Sales Return
create_sales_return 2 params body → 201
GET
/salesreturns
List all Sales Returns
list_sales_returns 3 params → 200
PUT
/salesreturns/{salesreturn_id}
Update a Sales Return
update_sales_return 3 params body → 200
GET
/salesreturns/{salesreturn_id}
Retrieve a Sales Return
get_sales_return 2 params → 200
DELETE
/salesreturns/{salesreturn_id}
Delete a Sales Return
delete_sales_return 2 params → 200
POST
/salesreturnreceives
Create a Sales Return Receive
create_sales_return_receive 2 params body → 201
DELETE
/salesreturnreceives/{salesreturnreceive_id}
Delete a Sales Return Receive
delete_sales_return_receive 2 params → 200

Schemas 67

The contract defines 67 schemas that model the data the API accepts and returns. The most detailed are salesreturn-response (12 properties), create-a-sales-return-request (6 properties), update-a-sales-return-request (6 properties), create-a-sales-return-receive-response (3 properties). Each schema is shown below with its type and property counts.

rate
number
Price of the line item in an entity.
storages-response
array
Bin/storage locations tracked for the line item. Returned for items with bin tracking enabled.
salesorder_item_id
string
Unique ID generated by the server for each line item in a sales order.
mapped_items_create
array
Items that are associated with the composite item (kit) in the line item. Applicable only when the line item is a kit type composite item.
date_description
string
Indicates the time duration since the action was performed
time
string
Indicates the time when the action was performed
transaction_type
string
Indicates the type of transaction.
salesorder_id
string
Unique ID generated by the server for the Sales Order from which the Sales Return is created.
salesreturn_id
string
Unique ID generated by the server for the Sales Return.
creditnote_id
string
Unique ID of the credit note generated by the server.
customer_id
string
Unique ID generated by the server for the customer.
create-a-sales-return-receive-response
object
3 properties
salesreturn-response
object
12 properties
comments
array
History related to the Sales Return.
mapped_items
array
Items that are associated with the composite item (kit) in the line item. Applicable only when the line item is a kit type composite item.
operation_type
string
Type of operation performed on the transaction
transaction_id
string
Unique ID generated by the server for the transaction. This is used as an identifier.
label
string
Label of the Custom Field
creditnotes
array
List of credit notes associated with a sales return.
create-a-sales-return-response
object
3 properties
value
string
Value of the Custom Field
customer_name
string
Name of the customer.
description
string
Description of the line item.
receive_id
string
Unique ID generated by the server for the Sales Return Receive. This is used as an identifier.
update-a-sales-return-response
object
3 properties
combo_type
string
Type of the composite item. Allowed values are assembly and kit .
item_id
string
Unique ID generated by the server for the item. This is used as an identifier.
custom_fields
array
Custom fields for a salesreturn.
salesreturn_status
string
Status of the Sales Return.
comment_type
string
Indicates the type of the action
commented_by
string
Indicates the user who performed the action on the purchase order.
update-a-sales-return-request
object
6 properties 1 required
status
string
Status of the credit note.
receive_number
string
Unique Sales Return Receive Number
refunded_amount
number
Total amount refunded to the customer.
mapped_items_receive
array
Items that are associated with the composite item (kit) in the line item. Applicable only when the line item is a kit type composite item.
location_id
string
Location ID
quantity
number
The quantity that can be received for the line item.
name
string
Name of the line item.
date
string
Date on which the entity was created.
unit
string
Measurement unit of the line item.
customfield_id
string
Unique ID of the custom field.
delete-a-sales-return-response
object
2 properties
salesreturn_number
string
Return Merchandise Authorisation (RMA) number of the Sales Return.
receive_status
string
Receive status of the Sales Return
storages
array
Bin/storage locations allocated for the line item. Applicable only for items with bin tracking enabled.
create-a-sales-return-receive-request
object
3 properties 1 required
delete-a-sales-return-receive-response
object
2 properties
comment_id
string
Unique ID generated by the server for the comment(history). This is used as an identifier.
batches
array
Batches for the line item. Create a new batch using batchnumber or reference an existing batch using batchid . Applicable only for items with batch tracking en…
refund_status
string
Refund status of the Sales Return
line_items
array
The underlying items in a Sales Return
is_combo_product
boolean
Indicates whether the line item is a composite product.
total
number
Total amount on the credit note.
create-a-sales-return-request
object
6 properties 1 required
serial_numbers
array
Serial numbers for the line item. Applicable only for items with serial tracking enabled.
notes
string
Notes for the current entity.
line_item_id
string
Unique ID generated by the server for each line item. This is used as an identifier.
reason
string
The reason for raising a Sales Return.
retrieve-a-sales-return-response
object
3 properties
creditnote_number
string
Unique number generated (starts with CN) which will be displayed in the interface and credit notes. Max-Length [100]
batches-response
array
Batches tracked for the line item. Returned for items with batch tracking enabled.
mapped_items_update
array
Items that are associated with the composite item (kit) in the line item. Applicable only when the line item is a kit type composite item.
location_name
string
Name of the location
non_receive_quantity
number
The quantity that cannot be received for the line item.
salesorder_number
string
Unique sales order number for each sales order.
list-all-sales-returns-response
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

zoho-inventory-sales-returns-api-openapi.yml Raw ↑

Other APIs Zoho Inventory publishes across the network.

Zoho Inventory batches API
AE Profile APIs.io
Zoho Inventory bills API
AE Profile APIs.io
Zoho Inventory compositeitems API
AE Profile APIs.io
Zoho Inventory contact-persons API
AE Profile APIs.io
Zoho Inventory contacts API
AE Profile APIs.io
Zoho Inventory credit-notes API
AE Profile APIs.io
Zoho Inventory currency API
AE Profile APIs.io
Zoho Inventory customer-payments API
AE Profile APIs.io
Zoho Inventory delivery-challans API
AE Profile APIs.io
Zoho Inventory inventoryadjustments API
AE Profile APIs.io
Zoho Inventory invoices API
AE Profile APIs.io
Zoho Inventory items API
AE Profile APIs.io
#Sales Returns
← Back to Z APIs
API Details
ID
zoho-inventory:zoho-inventory-sales-returns-api
Base URL
https://www.zohoapis.com/inventory/v1
Docs
https://www.zoho.com/inventory/api/v1/introduction/
Provider
Zoho Inventory
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=zoho-inventory-sales-returns-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/zoho-inventory-sales-returns-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Zoho Inventory Sales Returns API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.