v1

latestOpenAPI 3.0.3ISC2026-07-134096160.7 KB

Orders

Submit a Printify Express order

post/v1/shops/{shop_id}/orders/express.json

Request body

external_idstring nullable

labelstring nullable

shipping_methodinteger nullable

send_shipping_notificationboolean nullable

Example request

{
  "external_id": "2750e210-39bb-11e9-a503-452618153e4a",
  "label": "00012",
  "line_items": [
    {
      "product_id": "5bfd0b66a342bcc9b5563216",
      "variant_id": 17887,
      "quantity": 1,
      "external_id": "line-item-abc-001"
    }
  ],
  "shipping_method": 3,
  "address_to": {
    "first_name": "Jane",
    "last_name": "Smith",
    "address1": "ExampleBaan 121",
    "address2": "Apt 4B",
    "city": "Retie",
    "zip": "2470",
    "email": "example@msn.com",
    "phone": "0574 69 21 90",
    "country": "BE",
    "company": "MSN"
  }
}

Response

Successful operation

Example response

{
  "data": [
    {
      "type": "order",
      "id": "5a96f649b2439217d070f508",
      "attributes": {
        "app_order_id": "215014.44",
        "fulfilment_type": "express",
        "line_items": [
          {
            "product_id": "5b05842f3921c9547531758d",
            "quantity": 1,
            "variant_id": 12359,
            "print_provider_id": 5,
            "cost": 2200,
            "shipping_cost": 799,
            "status": "pending",
            "metadata": {
              "title": "18K gold plated Necklace",
              "price": 2200,
              "variant_label": "Golden indigocoin",
              "sku": "168699843",
              "country": "United States",
              "external_id": "line-item-abc-001"
            },
            "sent_to_production_at": "2023-10-18 13:24:28+00:00"
          }
        ]
      }
    }
  ]
}