Create Order

POST

/v1/orders

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/json

Example

{
    "reference_id": "20231111",
    "order_status": "draft",
    "boost_production": false,
    "line_items": [
        {
            "item_id": "1",
            "sku": "UTNGDT1W00L",
            "name": "Item 1",
            "quantity": 3,
            "print_areas": {
                "front": "url",
                "back": "url"
            },
            "preview_areas": {
                "front": "url",
                "back": "url"
            }
        }
    ],
     "address": {
        "name": "Michael Brown",
        "company": "My company",
        "email": "michaelbrown@demo.com",
        "phone": "(330) 829-0294",
        "street1": "3431 Reeves Street",
        "street2": null,
        "city": "Milwaukee",
        "state": "WI",
        "country": "US",
        "zip": "53202"
    },
    "shipping_method": 1,
    "gift_message": "string",
    "tax_id": "string",
    "tax_id_type": "string"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api-v2.fastpod.net/v1/orders' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "reference_id": "20231111",
    "order_status": "draft",
    "boost_production": false,
    "line_items": [
        {
            "item_id": "1",
            "sku": "UTNGDT1W00L",
            "name": "Item 1",
            "quantity": 3,
            "print_areas": {
                "front": "url",
                "back": "url"
            },
            "preview_areas": {
                "front": "url",
                "back": "url"
            }
        }
    ],
     "address": {
        "name": "Michael Brown",
        "company": "My company",
        "email": "michaelbrown@demo.com",
        "phone": "(330) 829-0294",
        "street1": "3431 Reeves Street",
        "street2": null,
        "city": "Milwaukee",
        "state": "WI",
        "country": "US",
        "zip": "53202"
    },
    "shipping_method": 1,
    "gift_message": "string",
    "tax_id": "string",
    "tax_id_type": "string"
}'

Responses

🟢200Success

application/json

Body

Examples

Success order regularSuccess order label

{
    "status": true,
    "message": "Order created successfully.",
    "data": {
        "id": "F255-010524-000001",
        "reference_id": "string",
        "order_status": "new_order",
        "test_order": false,
        "item_total": 16.8,
        "shipping_total": 4.99,
        "order_total": 21.79,
        "payment_method": "cash",
        "payment_status": "unpaid",
        "point_earned": 0,
        "point_used": 2179,
        "quantity_total": 1,
        "shipping_method": "1",
        "rush_production_price": 0,
        "rush_production": false,
        "gift_message": null,
        "tax_id": null,
        "tax_id_type": null,
        "created_at": "2024-01-05T02:50:03.000000Z",
        "updated_at": "2024-01-05T02:50:03.000000Z",
        "rejected_at": null,
        "rejected_reason": null,
        "cancelled_at": null,
        "address": {
            "name": "string",
            "company": "string",
            "email": "email",
            "phone": "string",
            "street1": "string",
            "street2": "string",
            "city": "string",
            "state": "string",
            "country": "US",
            "zip": "string"
        },
        "line_items": [
            {
                "print_areas": {
                    "front": "url",
                    "back": "url"
                },
                "preview_areas": {
                    "front": "url"
                },
                "id": 100539,
                "item_id": "string",
                "name": "string",
                "sku": "UABSTBLCKEXS",
                "style": "3001",
                "color": "BLACK",
                "size": "XS",
                "unit_price": 16.8,
                "quantity": 1,
                "point_earned": 0,
                "price": 16.8,
                "discount": 0,
                "product_name": "UNISEX JERSEY SHORT SLEEVE TEE",
                "shipping_price": 4.99
            }
        ],
        "shipments": [],
        "coupon_code": null,
        "discount_total": 0,
        "labeling_fee": 0,
        "order_type": 1,
        "discount_labeling_fee": 0,
        "apply_coupon": false,
        "message_coupon": "The coupon code is invalid"
    }
}

🟠422Parameter Error

Modified at 2024-01-09 00:33:37

Get Order

Cancel Order