> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://developer.shipbob.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developer.shipbob.com/_mcp/server. # 2026-07 ## Docs - [Introduction](https://developer.shipbob.com/introduction.md) - [Quickstart](https://developer.shipbob.com/quickstart.md) - [Authentication](https://developer.shipbob.com/auth.md): Learn how to authenticate with ShipBob's API using Personal Access Tokens or OAuth 2.0 - [Rate limit](https://developer.shipbob.com/rate-limit.md) - [Setup Sandbox Account](https://developer.shipbob.com/sandbox/setup.md): Learn how to setup a sandbox account on ShipBob - [Sandbox Simulations](https://developer.shipbob.com/sandbox/simulations.md) - [Checklist](https://developer.shipbob.com/sandbox/checklist.md): Use this checklist as you build your integration - [Demo Engine](https://developer.shipbob.com/sandbox/demo.md) - [Webhooks](https://developer.shipbob.com/webhooks.md) - [Overview](https://developer.shipbob.com/guides/overview.md): Use cases for how to build with the ShipBob API - [Orders](https://developer.shipbob.com/guides/orders.md) - [Build an Orders Integration](https://developer.shipbob.com/guides/build-orders-integration.md): A complete guide to creating and managing orders using the ShipBob API - [Amazon FBA Orders](https://developer.shipbob.com/guides/amazon-fba.md): How to create Amazon FBA Manual orders using the ShipBob API - [Products](https://developer.shipbob.com/guides/products.md): How to create and manage products with the ShipBob API - [Product Catalog](https://developer.shipbob.com/guides/product-catalog.md): API documentation for managing products through the ShipBob product catalog. - [Inventory](https://developer.shipbob.com/guides/inventory.md) - [Inventory History](https://developer.shipbob.com/guides/inventory-history.md): - [Tracking](https://developer.shipbob.com/guides/tracking.md) - [Receiving](https://developer.shipbob.com/guides/receiving.md): How to create and manage warehouse receiving orders using the ShipBob API - [Returns](https://developer.shipbob.com/guides/returns.md): How to create and manage returns using the ShipBob API - [Billing](https://developer.shipbob.com/guides/billing.md): Manage and retrieve billing-related data including invoices, transactions, and transaction fees - [Concepts](https://developer.shipbob.com/concepts.md) - [Status Reference](https://developer.shipbob.com/status-reference.md) - [MCP Server Overview](https://developer.shipbob.com/mcp-server/overview.md): Connect AI assistants like Claude Desktop and VS Code with GitHub Copilot to ShipBob using the Model Context Protocol (MCP). The ShipBob MCP Server is a hosted remote server with built-in OAuth. - [Setup](https://developer.shipbob.com/mcp-server/setup.md): Add the ShipBob MCP Server to your AI assistant. The flow is the same for every client: paste a URL, sign in to ShipBob, grant access. - [Tools & Examples](https://developer.shipbob.com/mcp-server/tools.md): All 73 tools exposed by the ShipBob MCP Server, organized by domain, plus example prompts you can use right away. - [Troubleshooting & FAQ](https://developer.shipbob.com/mcp-server/troubleshooting.md): Security best practices, common issues, frequently asked questions, and support contacts for the ShipBob MCP Server. - [Setup with API Token](https://developer.shipbob.com/mcp-server/setup-with-token.md): Connect to the ShipBob MCP Server by generating an API token from your ShipBob dashboard and pasting it into your AI assistant's configuration. - [Versioning Policy](https://developer.shipbob.com/versioning.md) - [Upgrade to 2025-07](https://developer.shipbob.com/versioning/2025-07.md): Migration guide for upgrading from version 2.0 to 2025-07 - [Upgrade to 2026-01](https://developer.shipbob.com/versioning/2026-01.md): Migration guide for upgrading from version 2025-07 to 2026-01 - [Upgrade to 2026-07](https://developer.shipbob.com/versioning/2026-07.md): Migration guide for upgrading from version 2026-01 to 2026-07 - [Migrate to PKCE](https://developer.shipbob.com/migration/pkce.md): Add PKCE (Proof Key for Code Exchange) to an existing OAuth app's authorization flow. - [Errors](https://developer.shipbob.com/errors.md): - [FAQ](https://developer.shipbob.com/faq.md): Common questions - [Release Notes](https://developer.shipbob.com/release-notes.md): Stay updated with the latest improvements, bug fixes, and new features. - [Best Practices](https://developer.shipbob.com/logistics/best-practices.md) - [ShipBob Logistics API](https://developer.shipbob.com/logistics/overview.md) - [Rate Shopping API](https://developer.shipbob.com/logistics/rate-shopping.md) - [Carriers](https://developer.shipbob.com/logistics/carriers.md): Setup carrier mapping with ShipBob Logistics - [Setup ShipBob Returns](https://developer.shipbob.com/labs/returns/setup.md): Getting Started with ShipBob Returns - [Configure Return Policies](https://developer.shipbob.com/labs/returns/policy.md): Set up return windows, reasons, review rules, and item eligibility in ShipBob Returns - [Automate Returns with Flows](https://developer.shipbob.com/labs/returns/flows.md): Use ShipBob Returns Flows to automate approvals, rejections, keep-item rules, and refunds - [Exchanges and Upcoming Outcomes](https://developer.shipbob.com/labs/returns/outcomes.md): Understand available and upcoming non-refund outcomes in ShipBob Returns - [Managing Returns Day-to-Day](https://developer.shipbob.com/labs/returns/manage.md): Review, approve, and troubleshoot returns in the ShipBob Returns dashboard - [Refunds, Fees & Deductions](https://developer.shipbob.com/labs/returns/refunds.md): Issue Shopify refunds, automate settlement, and configure refund deductions - [Return Statuses & Lifecycle Reference](https://developer.shipbob.com/labs/returns/statuses.md): Learn each return status, label state, and customer email trigger in ShipBob Returns - [What Your Customers See: Portal Walkthrough](https://developer.shipbob.com/labs/returns/customer-portal.md): A step-by-step walkthrough of the ShipBob Returns customer portal experience - [Analytics & Reports](https://developer.shipbob.com/labs/returns/analytics.md): Use analytics to identify return trends, product issues, and policy optimization opportunities ## API Docs - API Reference > Channels [Get Channels](https://developer.shipbob.com/api/channels/get-channels.md) - API Reference > Orders [Create Order](https://developer.shipbob.com/api/orders/create-order.md) - API Reference > Orders [Get Orders](https://developer.shipbob.com/api/orders/get-orders.md) - API Reference > Orders [Get Order](https://developer.shipbob.com/api/orders/get-order.md) - API Reference > Orders [Get Shipment](https://developer.shipbob.com/api/orders/get-shipment.md) - API Reference > Orders [Get Shipment Timeline](https://developer.shipbob.com/api/orders/get-shipment-timeline.md) - API Reference > Orders [Batch Cancel Shipments](https://developer.shipbob.com/api/orders/batch-cancel-shipments.md) - API Reference > Orders [Mark Tracking Uploaded](https://developer.shipbob.com/api/orders/mark-tracking-uploaded.md) - API Reference > Orders [Estimate Delivery Date ](https://developer.shipbob.com/api/orders/estimate-delivery-date.md) - API Reference > Orders > Additional [Estimate Fulfillment Cost For Order](https://developer.shipbob.com/api/orders/estimate-fulfillment-cost-for-order.md) - API Reference > Orders > Additional [Update Shipment Address ](https://developer.shipbob.com/api/orders/update-shipment-address.md) - API Reference > Orders > Additional [Get Shipment Line Items ](https://developer.shipbob.com/api/orders/get-shipment-line-items.md) - API Reference > Orders > Additional [Update Shipment Line Items ](https://developer.shipbob.com/api/orders/update-shipment-line-items.md) - API Reference > Orders > Additional [Update Shipment Line Items by SKU ](https://developer.shipbob.com/api/orders/update-shipment-line-items-by-sku.md) - API Reference > Orders > Additional [Assign Fulfillment Center ](https://developer.shipbob.com/api/orders/assign-fulfillment-center.md) - API Reference > Orders > Additional [Bulk Update Shipping Service ](https://developer.shipbob.com/api/orders/bulk-update-shipping-service.md) - API Reference > Orders > Additional [Bulk Place Shipments On Hold ](https://developer.shipbob.com/api/orders/bulk-place-shipments-on-hold.md) - API Reference > Orders > Additional [Bulk Release Shipments From Hold ](https://developer.shipbob.com/api/orders/bulk-release-shipments-from-hold.md) - API Reference > Orders > Additional [Cancel Order](https://developer.shipbob.com/api/orders/cancel-order.md) - API Reference > Orders > Additional [Cancel Shipment](https://developer.shipbob.com/api/orders/cancel-shipment.md) - API Reference > Orders > Additional [Get Shipping Methods](https://developer.shipbob.com/api/orders/get-shipping-methods.md) - API Reference > Orders > Additional [Get Shipment Status Timeline by Order ID and Shipment ID](https://developer.shipbob.com/api/orders/get-shipment-status-timeline-by-order-id-and-shipment-id.md) - API Reference > Orders > Additional [Get All Shipments for Order](https://developer.shipbob.com/api/orders/get-all-shipments-for-order.md) - API Reference > Orders > Additional [Get Shipment Logs by Order ID and Shipment ID](https://developer.shipbob.com/api/orders/get-shipment-logs-by-order-id-and-shipment-id.md) - API Reference > Orders > Additional [Cancel Shipment by Order ID and Shipment ID](https://developer.shipbob.com/api/orders/cancel-shipment-by-order-id-and-shipment-id.md) - API Reference > Orders > Additional [Get Shipment Logs](https://developer.shipbob.com/api/orders/get-shipment-logs.md) - API Reference > Orders > Additional [Get Shipment by Order ID and Shipment ID](https://developer.shipbob.com/api/orders/get-shipment-by-order-id-and-shipment-id.md) - API Reference > Orders > Additional [Get Order Store Data](https://developer.shipbob.com/api/orders/get-order-store-data.md) - API Reference > Orders > Additional [Get Completely Cancelled Orders](https://developer.shipbob.com/api/orders/get-completely-cancelled-orders.md) - API Reference > Orders > Additional [Bulk Update Instructions ](https://developer.shipbob.com/api/orders/bulk-update-instructions.md) - API Reference > Products [Create Product](https://developer.shipbob.com/api/products/create-product.md) - API Reference > Products [Get Products](https://developer.shipbob.com/api/products/get-products.md) - API Reference > Products [Get Product](https://developer.shipbob.com/api/products/get-product.md) - API Reference > Products [Update Product](https://developer.shipbob.com/api/products/update-product.md) - API Reference > Products > Variants [Get Product Variants](https://developer.shipbob.com/api/products/get-product-variants.md) - API Reference > Products > Variants [Add Product Variants](https://developer.shipbob.com/api/products/add-product-variants.md) - API Reference > Products > Variants [Update Product Variants](https://developer.shipbob.com/api/products/update-product-variants.md) - API Reference > Products > Variants [Merge Variants](https://developer.shipbob.com/api/products/merge-variants.md) - API Reference > Products > Variants [Move Variants Between Products](https://developer.shipbob.com/api/products/move-variants-between-products.md) - API Reference > Products > Variants [Move Variants to New Product](https://developer.shipbob.com/api/products/move-variants-to-new-product.md) - API Reference > Products > Additional [Get Packaging Requirement](https://developer.shipbob.com/api/products/get-packaging-requirement.md) - API Reference > Products > Additional [Get Taxonomies](https://developer.shipbob.com/api/products/get-taxonomies.md) - API Reference > Products > Additional [Get Taxonomy by ID](https://developer.shipbob.com/api/products/get-taxonomy-by-id.md) - API Reference > Products > Additional [Get Taxonomy Parent](https://developer.shipbob.com/api/products/get-taxonomy-parent.md) - API Reference > Products > Additional [Delete Product Bundle](https://developer.shipbob.com/api/products/delete-product-bundle.md) - API Reference > Products > Additional [Convert Variant to Bundle](https://developer.shipbob.com/api/products/convert-variant-to-bundle.md) - API Reference > Products > Additional [Get Allergens](https://developer.shipbob.com/api/products/get-allergens.md) - API Reference > Inventory [ Get All Inventory Levels ](https://developer.shipbob.com/api/inventory/get-all-inventory-levels.md) - API Reference > Inventory [ Get Inventory Levels ](https://developer.shipbob.com/api/inventory/get-inventory-levels.md) - API Reference > Inventory [Get Inventory](https://developer.shipbob.com/api/inventory/get-inventory.md) - API Reference > Inventory [Get All Inventories](https://developer.shipbob.com/api/inventory/get-all-inventories.md) - API Reference > Inventory [Query Inventory History Events](https://developer.shipbob.com/api/inventory/query-inventory-history-events.md) - API Reference > Inventory > By Fulfillment Center [ Get All Inventory Levels Grouped By Fulfillment Center ](https://developer.shipbob.com/api/inventory/get-all-inventory-levels-grouped-by-fulfillment-center.md) - API Reference > Inventory > By Fulfillment Center [ Get Inventory Levels Grouped By Fulfillment Center ](https://developer.shipbob.com/api/inventory/get-inventory-levels-grouped-by-fulfillment-center.md) - API Reference > Inventory > By Lot [ Get All Inventory Levels Grouped By Lot ](https://developer.shipbob.com/api/inventory/get-all-inventory-levels-grouped-by-lot.md) - API Reference > Inventory > By Lot [ Get Inventory Levels Grouped By Lot ](https://developer.shipbob.com/api/inventory/get-inventory-levels-grouped-by-lot.md) - API Reference > Inventory [ Get Lot Exclusions ](https://developer.shipbob.com/api/inventory/get-lot-exclusions.md) - API Reference > Inventory [ Create Lot Exclusion ](https://developer.shipbob.com/api/inventory/create-lot-exclusion.md) - API Reference > Inventory [ Restore Lot Exclusion ](https://developer.shipbob.com/api/inventory/restore-lot-exclusion.md) - API Reference > Inventory [ Delete Lot Exclusion ](https://developer.shipbob.com/api/inventory/delete-lot-exclusion.md) - API Reference > Receiving [Create Warehouse Receiving Order ](https://developer.shipbob.com/api/receiving/create-warehouse-receiving-order.md) - API Reference > Receiving [Get Multiple Warehouse Receiving Orders ](https://developer.shipbob.com/api/receiving/get-multiple-warehouse-receiving-orders.md) - API Reference > Receiving [Get Warehouse Receiving Order ](https://developer.shipbob.com/api/receiving/get-warehouse-receiving-order.md) - API Reference > Receiving [Get Fulfillment Centers ](https://developer.shipbob.com/api/receiving/get-fulfillment-centers.md) - API Reference > Receiving [Get Warehouse Receiving Order Boxes ](https://developer.shipbob.com/api/receiving/get-warehouse-receiving-order-boxes.md) - API Reference > Receiving [Get Warehouse Receiving Order Box Labels ](https://developer.shipbob.com/api/receiving/get-warehouse-receiving-order-box-labels.md) - API Reference > Receiving [Cancel Warehouse Receiving Order ](https://developer.shipbob.com/api/receiving/cancel-warehouse-receiving-order.md) - API Reference > Receiving [Set ExternalSync flag for Wros ](https://developer.shipbob.com/api/receiving/set-external-sync-flag-for-wros.md) - API Reference > Receiving [Get Inventory Distributions by WRO ID](https://developer.shipbob.com/api/receiving/get-inventory-distributions-by-wro-id.md) - API Reference > Receiving [Get Unidentified Receiving Orders ](https://developer.shipbob.com/api/receiving/get-unidentified-receiving-orders.md) - API Reference > Receiving [Get Unidentified Receiving Order ](https://developer.shipbob.com/api/receiving/get-unidentified-receiving-order.md) - API Reference > Receiving [Associate Unidentified Receiving Order with WRO ](https://developer.shipbob.com/api/receiving/associate-unidentified-receiving-order-with-wro.md) - API Reference > Receiving [Update Warehouse Receiving Order ](https://developer.shipbob.com/api/receiving/update-warehouse-receiving-order.md) - API Reference > Receiving [Update box tracking for a Warehouse Receiving Order ](https://developer.shipbob.com/api/receiving/update-box-tracking-for-a-warehouse-receiving-order.md) - API Reference > Returns [Create Return Order ](https://developer.shipbob.com/api/returns/create-return-order.md) - API Reference > Returns [Get Return Orders ](https://developer.shipbob.com/api/returns/get-return-orders.md) - API Reference > Returns [Get Return Order ](https://developer.shipbob.com/api/returns/get-return-order.md) - API Reference > Returns [Edit Return Order ](https://developer.shipbob.com/api/returns/edit-return-order.md) - API Reference > Returns [Cancel Return order ](https://developer.shipbob.com/api/returns/cancel-return-order.md) - API Reference > Webhooks [Create Subscription ](https://developer.shipbob.com/api/webhooks/create-subscription.md) - API Reference > Webhooks [Get Subscriptions ](https://developer.shipbob.com/api/webhooks/get-subscriptions.md) - API Reference > Webhooks [Delete Subscription ](https://developer.shipbob.com/api/webhooks/delete-subscription.md) - API Reference > Locations [Get Locations](https://developer.shipbob.com/api/locations/get-locations.md) - API Reference > Billing [Search Transactions](https://developer.shipbob.com/api/billing/search-transactions.md) - API Reference > Billing [Get Invoices](https://developer.shipbob.com/api/billing/get-invoices.md) - API Reference > Billing [Get Transactions by Invoice ID ](https://developer.shipbob.com/api/billing/get-transactions-by-invoice-id.md) - API Reference > Billing [Get Transaction Fees ](https://developer.shipbob.com/api/billing/get-transaction-fees.md) - API Reference > Tracking [Get Tracking by Shipment Ids ](https://developer.shipbob.com/api/tracking/get-tracking-by-shipment-ids.md) - API Reference > Tracking [Get Tracking by Tracking Ids ](https://developer.shipbob.com/api/tracking/get-tracking-by-tracking-ids.md) ## OpenAPI Specification The raw OpenAPI 3.1 specification for this API is available at: - [OpenAPI JSON](https://developer.shipbob.com/openapi.json) - [OpenAPI YAML](https://developer.shipbob.com/openapi.yaml)