Our API is currently in open beta, if you encounter any issues or have a suggestion, please email us at devs@lumaprints.com. Your insights are invaluable to us.

Submit a new order.

Sandbox

https://us.api-sandbox.lumaprints.com

POST

/api/v1/orders

Submit an order for fulfillment. If everthing is good with the data provided, you will be provided an order number. Submitted orders does not reflect instantly in your account. It might take a couple of minutes because submitted orders are processed through a queue.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

{
    "externalId": "186898732",
    "storeId": 818,
    "shippingMethod": "default",
    "productionTime": "regular",
    "specialInstructions": "This is a special order.",
    "printouts": [
        "https://www.example.com/printout1.jpg",
        "https://www.example.com/printout2.jpg",
        "https://www.example.com/printout3.jpg"
    ],
    "recipient": {
        "firstName": "John",
        "lastName": "Smith",
        "addressLine1": "123 Main St.",
        "addressLine2": "Apt. 123",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "country": "US",
        "phone": "123-456-7890",
        "company": "ABC Company"
    },
    "orderItems": [
        {
            "externalItemId": "123456789",
            "subcategoryId": 103001,
            "quantity": 1,
            "width": 8,
            "height": 10,
            "file": {
                "imageUrl": "https://www.example.com/image.jpg"
            },
            "orderItemOptions": [
                11,
                51,
                23
            ],
            "solidColorHexCode": null
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://us.api-sandbox.lumaprints.com/api/v1/orders' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
    "externalId": "186898732",
    "storeId": 818,
    "shippingMethod": "default",
    "productionTime": "regular",
    "specialInstructions": "This is a special order.",
    "printouts": [
        "https://www.example.com/printout1.jpg",
        "https://www.example.com/printout2.jpg",
        "https://www.example.com/printout3.jpg"
    ],
    "recipient": {
        "firstName": "John",
        "lastName": "Smith",
        "addressLine1": "123 Main St.",
        "addressLine2": "Apt. 123",
        "city": "New York",
        "state": "NY",
        "zipCode": "10001",
        "country": "US",
        "phone": "123-456-7890",
        "company": "ABC Company"
    },
    "orderItems": [
        {
            "externalItemId": "123456789",
            "subcategoryId": 103001,
            "quantity": 1,
            "width": 8,
            "height": 10,
            "file": {
                "imageUrl": "https://www.example.com/image.jpg"
            },
            "orderItemOptions": [
                11,
                51,
                23
            ],
            "solidColorHexCode": null
        }
    ]
}'

Responses

🟢201Order has been successfully submitted.

application/json

Body

Examples

SuccessSuccess

{
    "message": "The preliminary checks for the order submission were successful. It has now been placed in the queue for processing.",
    "orderNumber": 10000001440
}

🟠400Bad Request

🟠400Default billing address not set

🟠406Not Acceptable

Modified at 2025-04-03 17:28:57

Get multiple orders

Check image