aid: optoro name: Optoro description: 'Optoro is a returns management and reverse-logistics software company (Washington, DC; acquired by Blue Yonder in August 2025) whose OptiTurn platform powers the full returns lifecycle for retailers, brands and 3PLs — a shopper-facing returns portal and RMA workflow, in-store and warehouse returns processing, disposition and routing decisions, drop-ship fulfillment of returned and excess inventory, return-to-vendor agreements, and resale across secondary channels. Optoro publishes a public, API-first developer portal at developer.optoro.com covering seventeen OpenAPI 3.0/3.1 definitions across two directions: inbound APIs the retailer calls (Catalogs, Facilities, Drop Ship, RTV Vendor, ASN, External Bin Changes, Auth) and outbound webhooks/customer endpoints Optoro calls (RMAs, Disposition Update, Final Disposition, Outbound ASN, Exchange Orders, Exchange Variants, Drop Ship confirmation/cancellation). Authentication is OAuth 2.0 client credentials against auth.optiturn.com with 25-hour bearer tokens, and a full sandbox estate is published on *.sandbox.optiturn.com.' url: https://raw.githubusercontent.com/api-evangelist/optoro/refs/heads/main/apis.yml x-type: company x-source: harvest:secondary-market deliveryModel: model: saas open_source: false commercial: true callable_host: true label: Hosted service · you call their endpoint confidence: high source: - openapi - pricing generated: '2026-08-28' method: derived specificationVersion: '0.23' created: '2026-08-26' modified: '2026-08-26' image: https://www.optoro.com/wp-content/uploads/2024/03/optoro-home-hero-lg.png tags: - Returns Management - Reverse Logistics - Retail - Supply Chain - E-Commerce - Fulfillment - Dropship - Inventory - Webhook - Order Management tags_raw: - returns-management - reverse-logistics - retail - supply-chain - ecommerce - fulfillment - drop-ship - inventory - webhooks - order-management apis: - aid: optoro:optoro-asns-api name: Optoro Asns API description: The Asns API from Optoro — 2 operation(s) for asns. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - ASNs tags_raw: - Asns properties: - type: OpenAPI url: openapi/optoro-asns-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-catalog-entry-updates-api name: Optoro Catalog Entry Updates API description: The Catalog Entry Updates API from Optoro — 1 operation(s) for catalog entry updates. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Catalog Entry Updates properties: - type: OpenAPI url: openapi/optoro-catalog-entry-updates-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-dispositions-api name: Optoro Dispositions API description: The Dispositions API from Optoro — 1 operation(s) for dispositions. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Dispositions properties: - type: OpenAPI url: openapi/optoro-dispositions-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-drop-shipment-cancellation-api name: Optoro Drop Shipment Cancellation API description: >- The Drop Shipment Cancellation API from Optoro — 1 operation(s) for drop shipment cancellation. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Drop Shipment Cancellation properties: - type: OpenAPI url: openapi/optoro-drop-shipment-cancellation-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-drop-shipment-confirmation-api name: Optoro Drop Shipment Confirmation API description: >- The Drop Shipment Confirmation API from Optoro — 1 operation(s) for drop shipment confirmation. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Drop Shipment Confirmation properties: - type: OpenAPI url: openapi/optoro-drop-shipment-confirmation-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-drop-shipment-partial-cancellation-api name: Optoro Drop Shipment Partial Cancellation API description: >- The Drop Shipment Partial Cancellation API from Optoro — 1 operation(s) for drop shipment partial cancellation. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Drop Shipment Partial Cancellation properties: - type: OpenAPI url: openapi/optoro-drop-shipment-partial-cancellation-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-exchange-orders-api name: Optoro Exchange Orders API description: The Exchange Orders API from Optoro — 1 operation(s) for exchange orders. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Exchange - Orders tags_raw: - Exchange Orders properties: - type: OpenAPI url: openapi/optoro-exchange-orders-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-external-bin-changes-api name: Optoro External Bin Changes API description: The External Bin Changes API from Optoro — 2 operation(s) for external bin changes. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - External Bin Changes properties: - type: OpenAPI url: openapi/optoro-external-bin-changes-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-facilities-api name: Optoro Facilities API description: The Facilities API from Optoro — 1 operation(s) for facilities. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Facilities properties: - type: OpenAPI url: openapi/optoro-facilities-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-final-dispositions-api name: Optoro Final Dispositions API description: The Final Dispositions API from Optoro — 1 operation(s) for final dispositions. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Final Dispositions properties: - type: OpenAPI url: openapi/optoro-final-dispositions-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-forward-orders-api name: Optoro Forward Orders API description: The Forward Orders API from Optoro — 1 operation(s) for forward orders. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Forward Orders properties: - type: OpenAPI url: openapi/optoro-forward-orders-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-inventory-receipt-api name: Optoro Inventory Receipt API description: The Inventory Receipt API from Optoro — 1 operation(s) for inventory receipt. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Inventory Receipt properties: - type: OpenAPI url: openapi/optoro-inventory-receipt-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-listings-api name: Optoro Listings API description: The Listings API from Optoro — 2 operation(s) for listings. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Listings properties: - type: OpenAPI url: openapi/optoro-listings-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-oauth-api name: Optoro OAUTH API description: The Oauth API from Optoro — 1 operation(s) for oauth. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Authentication tags_raw: - Oauth properties: - type: OpenAPI url: openapi/optoro-oauth-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-orders-api name: Optoro Orders API description: The Orders API from Optoro — 3 operation(s) for orders. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Order tags_raw: - Orders properties: - type: OpenAPI url: openapi/optoro-orders-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-outbound-asn-api name: Optoro Outbound Asn API description: The Outbound Asn API from Optoro — 1 operation(s) for outbound asn. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Outbound Asn properties: - type: OpenAPI url: openapi/optoro-outbound-asn-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-returns-portal-orders-api name: Optoro Returns Portal Orders API description: The Returns Portal Orders API from Optoro — 1 operation(s) for returns portal orders. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Returns Portal Orders properties: - type: OpenAPI url: openapi/optoro-returns-portal-orders-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-rmas-api name: Optoro Rmas API description: The Rmas API from Optoro — 1 operation(s) for rmas. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Rmas properties: - type: OpenAPI url: openapi/optoro-rmas-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-shipments-api name: Optoro Shipments API description: The Shipments API from Optoro — 3 operation(s) for shipments. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Shipments properties: - type: OpenAPI url: openapi/optoro-shipments-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-sku-api name: Optoro Sku API description: The Sku API from Optoro — 1 operation(s) for sku. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - SKU tags_raw: - Sku properties: - type: OpenAPI url: openapi/optoro-sku-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks - aid: optoro:optoro-vendor-updates-api name: Optoro Vendor Updates API description: The Vendor Updates API from Optoro — 1 operation(s) for vendor updates. humanURL: https://developer.optoro.com/openapi/auth/openapi baseURL: https://auth.optiturn.com tags: - Vendor Updates properties: - type: OpenAPI url: openapi/optoro-vendor-updates-api-openapi.yml - type: Documentation url: https://developer.optoro.com/content/api_overview - type: Authentication url: authentication/optoro-authentication.yml - type: Documentation url: https://developer.optoro.com/content/rm_integration_guide - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Documentation url: https://developer.optoro.com/content/rx_integration_guide - type: Documentation url: https://developer.optoro.com/content/webhooks maintainers: - FN: Kin Lane email: kin@apievangelist.com - FN: APIs.json email: info@apis.io common: - type: CapabilityMap url: capabilities/optoro-capability-edges.yml name: Optoro Business Capability Map - type: Overlay url: overlays/optoro-auth-overlay.yaml - type: Overlay url: overlays/optoro-catalogs-overlay.yaml - type: Overlay url: overlays/optoro-facilities-overlay.yaml - type: Overlay url: overlays/optoro-rtv-overlay.yaml - type: Overlay url: overlays/optoro-asn-overlay.yaml - type: Overlay url: overlays/optoro-external-bin-changes-overlay.yaml - type: AgentSkill url: skills/optoro-drop-ship-order.md - type: AgentSkill url: skills/optoro-returns-experience.md - type: Overlay url: overlays/optoro-returns-portal-orders-overlay.yaml - type: Overlay url: overlays/optoro-rmas-overlay.yaml - type: AgenticAccess url: agentic-access/optoro-agentic-access.yml - type: VulnerabilityDisclosure url: security/optoro-vulnerability-disclosure.yml - type: DomainSecurity url: security/optoro-domain-security.yml - type: Website url: https://www.optoro.com/ - type: DeveloperPortal url: https://developer.optoro.com/ - type: Documentation url: https://developer.optoro.com/content/api_overview - type: APIReference url: https://developer.optoro.com/openapi/rmas/openapi - type: GettingStarted url: https://developer.optoro.com/content/rx_integration_guide - type: Blog url: https://www.optoro.com/returns-blog/ - type: Support url: https://help.optoro.com/hc/en-us - type: TermsOfService url: https://www.optoro.com/terms-conditions/ - type: PrivacyPolicy url: https://www.optoro.com/privacy-policy/ - type: Login url: https://optiturn.com/session/new - type: GitHubOrganization url: https://github.com/optoro - type: StatusPage url: https://status.optiturn.com/ - type: LLMsTxt url: llms/optoro-llms.txt - type: Webhooks url: asyncapi/optoro-webhooks.yml - type: Authentication url: authentication/optoro-authentication.yml - type: OAuthScopes url: scopes/optoro-scopes.yml - type: Conventions url: conventions/optoro-conventions.yml - type: ErrorCatalog url: errors/optoro-problem-types.yml - type: Lifecycle url: lifecycle/optoro-lifecycle.yml - type: Conformance url: conformance/optoro-conformance.yml - type: Compliance url: https://www.optoro.com/security/ - type: TrustCenter url: https://www.optoro.com/security/ - type: DataModel url: data-model/optoro-data-model.yml - type: Sandbox url: sandbox/optoro-sandbox.yml - type: ChangeLog url: changelog/optoro-changelog.yml - type: RateLimits url: rate-limits/optoro-rate-limits.yml - type: Plans url: plans/optoro-plans-pricing.yml - type: Packages url: packages/optoro-packages.yml - type: MCPServer url: mcp/optoro-mcp.yml - type: AgentSkill url: skills/_index.yml - type: Overlay url: overlays/optoro-drop-ship-overlay.yaml - type: Security url: https://www.optoro.com/security/ x-enrichment: date: '2026-08-26' status: enriched artifacts_added: 76 pass: local-v1