BigCommerce · Schema
ReturnItem
A view of a returned item.
E-CommerceRetailCatalogOrderCheckoutPaymentsSoftware-as-a-Service
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | The unique identifier of this returned item. |
| reference_id | object | |
| quantity | integer | The quantity of items for which a return was requested. |
| total | string | The total price of the line item. |
| preferred_outcome | object | |
| reason | object | |
| received_state | object | |
| review_state | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/ReturnItem",
"title": "ReturnItem",
"type": "object",
"description": "A view of a returned item.",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "The unique identifier of this returned item."
},
"reference_id": {
"$ref": "#/components/schemas/ItemReferenceId"
},
"quantity": {
"type": "integer",
"description": "The quantity of items for which a return was requested."
},
"total": {
"type": "string",
"format": "decimal",
"description": "The total price of the line item."
},
"preferred_outcome": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Unique identifier of the preferred outcome."
},
"label": {
"type": "string",
"description": "A displayable label for the preferred outcome."
}
}
},
"reason": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Unique identifier of the reason."
},
"label": {
"type": "string",
"description": "A displayable label for the reason."
}
}
},
"received_state": {
"type": "object",
"properties": {
"received_quantity": {
"type": "integer",
"description": "The quantity of items marked as received by the merchant."
},
"pending_quantity": {
"type": "integer",
"description": "The quantity of items pending receipt by the merchant."
}
}
},
"review_state": {
"type": "object",
"properties": {
"approved_quantity": {
"type": "integer",
"description": "The quantity of items approved for return by the merchant."
},
"pending_quantity": {
"type": "integer",
"description": "The quantity of items pending receipt by the merchant."
},
"rejected_quantity": {
"type": "integer",
"description": "The quantity of items rejected by the merchant."
}
}
}
},
"x-internal": false
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/bigcommerce-returnitem"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.