GET orders/{id}

Get a single order by ID.

Request

URL parameters

These parameters are specified as part of the URL.

Property Description Type Details
id The order ID. string Required

Response

Body

The order.

Property Description Type Details
Id The ID assigned to the order. string -
DateTime The date/time the order was created. ISO 8601 date -
Status The status of the order. OrderStatus -
TrackingUrl The tracking URL provided by our shipping partner. May become available on status "Shipped". In rare cases the tracking URL may be absent, so always check if it is present. string -
Email Optional customer e-mail address. string -
Username Optional customer username. string -
ProductionSpeed The production speed of this order. ProductionSpeed -
Checkout Print API payment screen data about the order. Only present if you enabled the payment screen in your application settings before submitting the order. out:CheckoutInfo -
Items The items belonging to the order. out:Item -
Metadata Optional metadata stored with the order. string -
Shipping The shipping address and method of the order. out:Shipping -
Invoice The costs of the order. out:Invoice - 
{
  "id": "83432183",
  "dateTime": "2025-01-01T06:12:24.0508061",
  "status": "Created",
  "email": "info@printapi.nl",
  "productionSpeed": "Standard",
  "checkout": {
    "amount": 99.99,
    "setupUrl": "https://test.printapi.nl/v2/checkout/k56xz0u2lc5mOp3t4CcZ"
  },
  "items": [
    {
      "id": "07453",
      "productId": "boek_hc_a5_sta",
      "pageCount": 32,
      "quantity": 1,
      "files": {
        "content": {
          "status": "DownloadPending",
          "downloadUrl": "https://www.printapi.nl/sample-book-a5-content.pdf"
        },
        "cover": {
          "status": "DownloadPending",
          "downloadUrl": "https://www.printapi.nl/sample-book-a5-cover.pdf"
        }
      }
    },
    {
      "id": "18557",
      "productId": "poster_a3_sta",
      "pageCount": 1,
      "quantity": 10,
      "files": {
        "content": {
          "status": "AwaitingUpload",
          "uploadUrl": "https://test.printapi.nl/v2/files/qYgtKyiRCj5myJ6cYC4t"
        }
      },
      "metadata": "{ \"my_file\": \"wswU7jPMloKSD5GhDFf9hbRQiXiTYj.jpg\" }"
    }
  ],
  "shipping": {
    "method": {
      "name": "Pakket (M)",
      "isTrackable": true
    },
    "address": {
      "name": "Print API",
      "line1": "Osloweg 75",
      "postCode": "9700 GE",
      "city": "Groningen",
      "country": "NL"
    }
  },
  "invoice": {
    "production": {
      "cost": 39.24,
      "taxes": [
        {
          "rate": 0.06,
          "amount": 0.57
        },
        {
          "rate": 0.21,
          "amount": 6.24
        }
      ]
    },
    "shipping": {
      "cost": 5.95,
      "taxes": [
        {
          "rate": 0.21,
          "amount": 1.25
        }
      ]
    },
    "handling": {
      "cost": 1.50,
      "taxes": [
        {
          "rate": 0.21,
          "amount": 0.32
        }
      ]
    },
    "total": {
      "cost": 46.69,
      "taxes": [
        {
          "rate": 0.21,
          "amount": 7.81
        },
        {
          "rate": 0.06,
          "amount": 0.57
        }
      ]
    }
  },
  "invoicingState": "Included"
}
<?xml version="1.0"?>
<Order xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <Id>83432183</Id>
  <DateTime>2025-01-01T06:12:24.0508061+01:00</DateTime>
  <Status>Created</Status>
  <Email>info@printapi.nl</Email>
  <ProductionSpeed>Standard</ProductionSpeed>
  <Checkout>
    <Amount>99.99</Amount>
    <SetupUrl>https://test.printapi.nl/v2/checkout/k56xz0u2lc5mOp3t4CcZ</SetupUrl>
    <Status xsi:nil="true" />
  </Checkout>
  <Items>
    <Item>
      <Id>07453</Id>
      <ProductId>boek_hc_a5_sta</ProductId>
      <PageCount>32</PageCount>
      <Quantity>1</Quantity>
      <Retail xsi:nil="true" />
      <Files>
        <Content>
          <Status>DownloadPending</Status>
          <DownloadUrl>https://www.printapi.nl/sample-book-a5-content.pdf</DownloadUrl>
        </Content>
        <Cover>
          <Status>DownloadPending</Status>
          <DownloadUrl>https://www.printapi.nl/sample-book-a5-cover.pdf</DownloadUrl>
        </Cover>
      </Files>
    </Item>
    <Item>
      <Id>18557</Id>
      <ProductId>poster_a3_sta</ProductId>
      <PageCount>1</PageCount>
      <Quantity>10</Quantity>
      <Retail xsi:nil="true" />
      <Files>
        <Content>
          <Status>AwaitingUpload</Status>
          <UploadUrl>https://test.printapi.nl/v2/files/qYgtKyiRCj5myJ6cYC4t</UploadUrl>
        </Content>
      </Files>
      <Metadata>{ "my_file": "wswU7jPMloKSD5GhDFf9hbRQiXiTYj.jpg" }</Metadata>
    </Item>
  </Items>
  <Shipping>
    <Method>
      <Name>Pakket (M)</Name>
      <IsTrackable>true</IsTrackable>
    </Method>
    <Address>
      <Name>Print API</Name>
      <Line1>Osloweg 75</Line1>
      <PostCode>9700 GE</PostCode>
      <City>Groningen</City>
      <Country>NL</Country>
    </Address>
  </Shipping>
  <Invoice>
    <Production>
      <Cost>39.24</Cost>
      <Taxes>
        <Tax>
          <Rate>0.06</Rate>
          <Amount>0.57</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
        <Tax>
          <Rate>0.21</Rate>
          <Amount>6.24</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
      </Taxes>
    </Production>
    <Shipping>
      <Cost>5.95</Cost>
      <Taxes>
        <Tax>
          <Rate>0.21</Rate>
          <Amount>1.25</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
      </Taxes>
    </Shipping>
    <Handling>
      <Cost>1.50</Cost>
      <Taxes>
        <Tax>
          <Rate>0.21</Rate>
          <Amount>0.32</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
      </Taxes>
    </Handling>
    <Total>
      <Cost>46.69</Cost>
      <Taxes>
        <Tax>
          <Rate>0.21</Rate>
          <Amount>7.81</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
        <Tax>
          <Rate>0.06</Rate>
          <Amount>0.57</Amount>
          <CalculatedOver xsi:nil="true" />
        </Tax>
      </Taxes>
    </Total>
  </Invoice>
  <InvoicingState>Included</InvoicingState>
</Order>