# Kibo Commerce Return API

**Canonical:** https://apis.io/apis/kibo-commerce/kibo-commerce-return-api/  
**Provider:** Kibo Commerce — https://apis.io/providers/kibo-commerce/  
**Base URL:** https://t1000000.sb.usc1.gcp.kibocommerce.com/api  
**Documentation:** https://docs.kibocommerce.com/api-overviews/getting-started

Kibo Commerce Return API is one of 221 APIs that [Kibo Commerce](https://apis.io/providers/kibo-commerce/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 119 JSON Schema definitions. Tagged areas include Return. The published artifact set on APIs.io includes an OpenAPI specification and 119 JSON Schemas.

The Return API from Kibo Commerce — 29 operation(s) for return.

## Operations (43)

| Method | Path | Summary |
|---|---|---|
| POST | `/commerce/returns/{returnId}/packages` | Add Package to Return |
| POST | `/commerce/returns/{returnId}/autorefund` | Auto Refund Return |
| POST | `/commerce/returns/{returnId}/payments/actions` | Create Payment Action For Return |
| POST | `/commerce/returns/{returnId}/shipments` | Create Return Shipment |
| POST | `/commerce/returns/{returnId}/ship` | Create Return Shipping Order |
| DELETE | `/commerce/returns/{orderId}/items/{orderItemId}` | Delete Order Item |
| POST | `/commerce/returns/{returnId}/disposition` | Dispose Return Items |
| GET | `/commerce/returns/{returnId}/actions` | Get Available Return Actions |
| GET | `/commerce/returns/restock/conditions` | Get Item Conditions |
| GET | `/commerce/returns/{returnId}/payments/{paymentId}` | Get Payment |
| GET | `/commerce/returns/{returnId}/paymentDistribution` | Get Payment Distribution |
| GET | `/commerce/returns/{returnId}/payments` | Get Payments |
| GET | `/commerce/returns/reasons` | Get Reasons |
| DELETE | `/commerce/returns/{returnId}` | Delete Return |
| GET | `/commerce/returns/{returnId}` | Get Return |
| PUT | `/commerce/returns/{returnId}` | Update Return |
| GET | `/commerce/returns/{returnId}/attributes` | Get Return Attributes |
| POST | `/commerce/returns/{returnId}/attributes` | Create Return Attributes |
| PUT | `/commerce/returns/{returnId}/attributes` | Update Return Attributes |
| GET | `/commerce/returns/{returnId}/items/{returnItemId}` | Get Return Item |
| GET | `/commerce/returns/{returnId}/items/{returnItemId}/attributes` | Get Return Item Attributes |
| POST | `/commerce/returns/{returnId}/items/{returnItemId}/attributes` | Create Return Item Attributes |
| PUT | `/commerce/returns/{returnId}/items/{returnItemId}/attributes` | Update Return Item Attributes |
| GET | `/commerce/returns/{returnId}/items` | Get Return Items |
| POST | `/commerce/returns/{returnId}/items` | Create Return Item |
| GET | `/commerce/returns/{returnId}/shipping/label` | Get Return Label |
| DELETE | `/commerce/returns/{returnId}/notes/{noteId}` | Delete Return Note |
| GET | `/commerce/returns/{returnId}/notes/{noteId}` | Get Return Note |
| PUT | `/commerce/returns/{returnId}/notes/{noteId}` | Update Return Note |
| GET | `/commerce/returns/{returnId}/notes` | Get Return Notes |
| POST | `/commerce/returns/{returnId}/notes` | Create Return Note |
| DELETE | `/commerce/returns/{returnId}/packages/{packageId}` | Delete Return Package |
| GET | `/commerce/returns/{returnId}/packages/{packageId}` | Get Return Package |
| PUT | `/commerce/returns/{returnId}/packages/{packageId}` | Update Return Package |
| GET | `/commerce/returns/{returnId}/packages/{packageId}/label` | Get Return Package Label |
| DELETE | `/commerce/returns/{returnId}/shipments/{shipmentId}` | Delete Return Shipment |
| GET | `/commerce/returns/{returnId}/shipments/{shipmentId}` | Get Return Shipment |
| GET | `/commerce/returns` | Get Returns |
| POST | `/commerce/returns` | Create Returns |
| POST | `/commerce/returns/{returnId}/payments/{paymentId}/actions` | Perform Payment Action For Return |
| POST | `/commerce/returns/actions` | Perform Return Action |
| PUT | `/commerce/returns/email/resend` | Resend Return Email |
| POST | `/commerce/returns/{returnId}/restock` | Restock Return Items |

## Machine-readable artifacts (120)

- **OpenAPI** — https://artifacts.apis.io/kibo-commerce/openapi/kibo-commerce-return-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-package-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-application-entitlement-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-application-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-headless-app-runtime-log-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-http-response-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-application-subscription-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-history-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-history-collection-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-admins-product-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-admins-discount-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-product-v1-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-admins-attribute-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-admins-discount-target-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-product-variation-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-product-for-indexing-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-runtimes-product-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-product-validation-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-configured-product-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-catalog-runtimes-category-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-campaign-result-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-order-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-order-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-wishlist-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-cart-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-return-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-cart-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-document-list-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-document-list-type-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-document-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-property-type-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-document-type-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-content-http-request-message-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-customer-account-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-b2-baccount-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-purchase-order-transaction-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-customer-credit-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-customer-attribute2-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-b2-buser-schema.json
- **JSONSchema** — https://artifacts.apis.io/kibo-commerce/json-schema/kibo-commerce-transaction-set-schema.json
- …and 80 more, listed in full on the page.

## Other Kibo Commerce APIs (12)

- [Kibo Commerce Account Ranking Rule API](https://apis.io/apis/kibo-commerce/kibo-commerce-accountrankingrule-api/)
- [Kibo Commerce Address Validation API](https://apis.io/apis/kibo-commerce/kibo-commerce-addressvalidation-api/)
- [Kibo Commerce Admin Auth Ticket API](https://apis.io/apis/kibo-commerce/kibo-commerce-adminauthticket-api/)
- [Kibo Commerce Admin Group API](https://apis.io/apis/kibo-commerce/kibo-commerce-admingroup-api/)
- [Kibo Commerce Admin User API](https://apis.io/apis/kibo-commerce/kibo-commerce-adminuser-api/)
- [Kibo Commerce App Auth Tickets API](https://apis.io/apis/kibo-commerce/kibo-commerce-appauthtickets-api/)
- [Kibo Commerce App Event API](https://apis.io/apis/kibo-commerce/kibo-commerce-appevent-api/)
- [Kibo Commerce App Install API](https://apis.io/apis/kibo-commerce/kibo-commerce-appinstall-api/)
- [Kibo Commerce B2B Account API](https://apis.io/apis/kibo-commerce/kibo-commerce-b2baccount-api/)
- [Kibo Commerce B2B Contact API](https://apis.io/apis/kibo-commerce/kibo-commerce-b2bcontact-api/)
- [Kibo Commerce B2B Settings API](https://apis.io/apis/kibo-commerce/kibo-commerce-b2bsettings-api/)
- [Kibo Commerce Backorder Rebalancing Rules API](https://apis.io/apis/kibo-commerce/kibo-commerce-backorderrebalancingrules-api/)

## Tags

Return

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/kibo-commerce/kibo-commerce-return-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/kibo-commerce/.
