Ultimate Custom Order Status API

Programmatically manage order statuses, send notifications, and retrieve order data

Getting Started

The Ultimate Custom Order Status API allows you to programmatically interact with your order management system. You can retrieve orders, update statuses, send customer notifications, and more.

Base URL

API Base URL

https://api.ultimate-custom-order-status.apps.msmtech.ca/api

Order ID Types

The API supports two types of order identifiers. You can choose which type to use based on your integration needs:

•Internal UUID: Unique identifier assigned by our system (e.g., 550e8400-e29b-41d4-a716-446655440000). This is the default.
•Shopify Order ID: Numeric ID from Shopify's GID format (e.g., extract 450789469 from gid://shopify/Order/450789469).
•Use the use_shopify_order_id parameter (query or body depending on endpoint) set to true to look up orders using Shopify IDs instead of internal UUIDs.

Available Endpoints

GET/v1/orders

Retrieve a paginated list of orders with filtering, sorting, and search capabilities.

GET/v1/orders/:order_id

Retrieve detailed information about a specific order by its ID.

GET/v1/statuses

Retrieve a list of all custom order statuses configured in your system.

GET/v1/statuses/:status_id

Retrieve detailed information about a specific custom order status by its ID.

POST/v1/orders/:order_id/notify

Forcibly send customer notifications (email, SMS, WhatsApp) for a specific order.

POST/v1/orders/:order_id/status

Update the custom status of a specific order. Automatically sends notifications based on status configuration.

POST/v1/orders/notify-bulk

Send notifications to customers for multiple orders in a single request.

POST/v1/orders/status-bulk

Update the custom status for multiple orders in a single request.

1. Generate an API key from your dashboard

Navigate to your app's Settings → API Keys section to generate a new API key. Make sure to save it securely as it will only be shown once.

Authentication Header

Include your API key in the X-API-Key header with every request:

Required Authentication Header

X-API-Key: your_api_key_here

2. Make your first API request with proper authentication

Example API Request

curl -X GET "https://api.ultimate-custom-order-status.apps.msmtech.ca/api/v1/orders" \
  -H "X-API-Key: your_api_key_here" \
  -H "Content-Type: application/json"

3. Handle the Response

All successful responses return JSON with a consistent structure. Check the specific endpoint documentation for response formats.