Retrieve an order by Safe ID

GET

/v1/orders/safeId/{safeId}

This endpoint allows you to retrieve information about an order using the order Safe ID.

Request

Path Params

Responses

🟢200OK

text/plain

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.dev.ordermesh.io/v1/orders/safeId/'

Response Example

200 - Success Example

{
    "order": {
        "items": [
            {
                "id": "7890abcdef123456",
                "shortId": "I12345678",
                "externalId": "EXT789012",
                "sku": "MERCH-TSHIRT-BLACK-M",
                "originalSKU": "TSHIRT-5000-M-BLACK",
                "quantity": 2,
                "status": "Fulfilled",
                "statusDesc": null,
                "createdAt": "2026-02-27T22:29:29.4914307Z",
                "updatedAt": null,
                "processedAt": null,
                "cancelledAt": null,
                "images": null,
                "options": null,
                "attributes": null,
                "customerSubtotal": {
                    "currency": "USD",
                    "amount": 20
                },
                "customerPrice": {
                    "currency": "USD",
                    "amount": 10
                },
                "customerShippingPrice": {
                    "currency": "USD",
                    "amount": 5
                },
                "customerTaxes": null,
                "merchantPrice": null,
                "merchantShippingPrice": null,
                "merchantTax": null,
                "merchantSubTotal": null,
                "merchantItemTotal": null,
                "clientAttributes": null,
                "meta": null,
                "isSample": true,
                "skipImgManip": false,
                "skipImageValidation": false,
                "skipSkuValidation": false,
                "fulfillmentReady": false,
                "refundData": null
            }
        ],
        "merchantItemTotal": null,
        "merchantTaxTotal": null,
        "merchantShippingTotal": null,
        "merchantTotal": null,
        "reprint": {
            "originalOrderId": "65add270441de72442397b6e",
            "reasonId": "reason_1",
            "shipments": [
                {
                    "facilityId": "facility-Id",
                    "shippingMethod": "Standard",
                    "costCoverage": {
                        "item": "Merchant",
                        "shipping": "Customer"
                    },
                    "items": [
                        {
                            "sku": "TSHIRT-5000-M-BLACK",
                            "quantity": 2
                        }
                    ]
                }
            ]
        },
        "facilityNames": [
            "Facility 1",
            "Facility 2"
        ],
        "shipmentCreatedDates": [
            "2026-02-27T22:29:29.4914352Z",
            "2026-02-28T22:29:29.4914354Z"
        ],
        "shipmentIds": [
            "SHIP123456",
            "SHIP789012"
        ],
        "id": "65add270441de72442397b6e",
        "shortId": "O04790082",
        "shippingAddress": {
            "location": null,
            "firstName": "Emily",
            "lastName": "Williams",
            "line1": "475 Oak Avenue",
            "line2": "Suite 2B",
            "line3": null,
            "city": "Pleasantville",
            "state": "NJ",
            "zip": "08232",
            "countryCode": "US",
            "phone": "609-555-0123",
            "email": "emily.w@example.com"
        },
        "billingAddress": {
            "location": null,
            "firstName": "Emily",
            "lastName": "Williams",
            "line1": "475 Oak Avenue",
            "line2": "Suite 2B",
            "line3": null,
            "city": "Pleasantville",
            "state": "NJ",
            "zip": "08232",
            "countryCode": "US",
            "phone": "609-555-0123",
            "email": "billing@example.com"
        },
        "returnAddress": null,
        "externalId": "75a452bf-d245-45da-9f65-a4d7957d8893",
        "safeId": "0f438c56-5ebe-4090-8d90-e0bba7cbb52c",
        "languageCode": "en",
        "customerTotal": {
            "currency": "USD",
            "amount": 30
        },
        "customerItemTotal": {
            "currency": "USD",
            "amount": 20
        },
        "customerTotalShipping": {
            "currency": "USD",
            "amount": 5
        },
        "customerTotalTaxes": {
            "currency": "USD",
            "amount": 5
        },
        "customerTotalDiscountAndPromotions": {
            "currency": "USD",
            "amount": 0
        },
        "customerPaymentMethods": [
            {
                "method": "Debit Card",
                "subMethod": "Visa",
                "cardFirst4": "1234",
                "cardLast4": "1234",
                "billingInfo": {
                    "fullName": "Emily Williams",
                    "address": {
                        "location": null,
                        "firstName": "Emily",
                        "lastName": "Williams",
                        "line1": "475 Oak Avenue",
                        "line2": "Suite 2B",
                        "line3": null,
                        "city": "Pleasantville",
                        "state": "NJ",
                        "zip": "08232",
                        "countryCode": "US",
                        "phone": "609-555-0123",
                        "email": ""
                    }
                },
                "customerTransactions": [
                    {
                        "total": {
                            "currency": "USD",
                            "amount": 30
                        },
                        "transactionDate": "01/22/2024 02:26:56",
                        "transactionId": "TX12345678",
                        "authorizationCode": "AUTH7890"
                    }
                ]
            }
        ],
        "status": "Open",
        "billingStatus": "Refunded",
        "merchantId": "46bae16f-3ccd-4afa-90d2-706551acbed7",
        "merchantName": "Test Merchant",
        "customerShippingMethod": "Standard",
        "isTest": true,
        "isSample": true,
        "createdAt": "2024-01-22T02:26:56.56+00:00",
        "updatedAt": null,
        "cancelledAt": null,
        "meta": {
            "additionalProp1": "Test"
        },
        "allowExternalOrderIdDuplication": false,
        "isPollingStopped": false,
        "automaticProcessing": null
    }
}

Modified at 2026-02-27 22:33:53

Update order data.

Retrieve order item by Order Item ID