{"info":{"_postman_id":"6e70da4e-404d-423c-a59b-1efb3c0cbe6f","name":"API Overview","description":"Do you sell or bulk purchase customised clothing and require a company to do the fulfilment? With the Clothes2order ordering API, you can set up your own website or other ordering medium and send orders directly to us electronically in real time. We’ll then dispatch the completed order straight to you or your customer.
\n![](\"https://content.pstmn.io/d9adc22b-a941-4d22-a308-6e31b2044557/aW1hZ2UucG5n\")
\n\nEvery order placed via our API receives the same expert service as any other Clothes2order order, so you can sure of receiving the best possible end result when ordering with us. To find out more about our API and view in depth technical specifications, please click the links on the left hand side.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"34924792","collectionId":"6e70da4e-404d-423c-a59b-1efb3c0cbe6f","publishedId":"2sA3s7i91D","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2024-08-15T11:31:25.000Z"},"item":[{"name":"Registering for our API","item":[],"id":"c15d9f02-3ae9-4142-8d00-2bafc01f9ad9","description":"Clothes2order API access is available to approved users only. Please note that we do not charge any on-going additional fees to place orders via our API, however all applicants to use the API must meet the following basic requirements:
\n\nHave an existing platform in place to accept orders
\nBe able to send orders electronically to us in XML or JSON format
\nHave a physical contact address and some kind of customer service (minimum by email)
\nHave the technical expertise (or access to the technical expertise) required to integrate an API with your own platform
\n
\nIf you fulfil these criteria and would like to work with Clothes2order, we would be delighted to hear from you. Please click here and fill in our API application form and we will assess your application as soon as possible.
\nOnce approved, you will receive email confirmation and you will be able to log into your API Account online. You will also receive email confirmation if your application to use our API is rejected.
\n","_postman_id":"c15d9f02-3ae9-4142-8d00-2bafc01f9ad9"},{"name":"Your API Account","item":[{"name":"Your API Key","item":[],"id":"2dd65a4c-14f7-4809-8951-c1a8d34231ac","description":"Your API key is automatically generated when your account is created and is clearly shown when logged into your account. API keys are 64 characters in length. Anyone who has your API key can place an order through our API using your account so it’s important not to share this key or make it publically visible in any way.
\nClicking ‘Generate a new API key’ from your account will generate a new key; please note that your previous key will instantly cease to work once your new key is generated.
\n","_postman_id":"2dd65a4c-14f7-4809-8951-c1a8d34231ac"},{"name":"Data Feeds","item":[],"id":"29281218-2870-4cc8-89fe-e23b5c23df36","description":"There are several distinct data feeds in csv format available for the Clothes2order API. All can be downloaded from your account or automatically via the direct links provided in your account if required.
\n\nThis feed contains a list of all product SKU’s and stock information and is updated every 30 minutes. The feed is hosted on the Amazon S3 Cloud which means it can be fetched regularly by API users without restriction. The csv columns are listed below:
\n\n\n\n| Column Name | \nDescription | \n
\n\n\n\n| Product Name | \nThe name of the product. | \n
\n\n| Product Category | \nThe name of the primary category the product sits in on the Clothes2order site. | \n
\n\n| Manufacturer Code | \nThe manufacturer code for the product (if available). | \n
\n\n| Colour | \nThe colour of the product for this SKU. | \n
\n\n| Size | \nThe size of the product for this SKU. | \n
\n\n| SKU | \nThe SKU code. This is the key part that needs to passed to the API to order a product. | \n
\n\n| Is Core | \nIndicates if this is a ‘core’ SKU. Core lines are generally our best sellers and are available for 24 hour dispatch. | \n
\n\n| In Stock | \nIndicates if this SKU is currently in stock or not. | \n
\n\n| Approx Stock Level | \nShows the approximate stock available for that SKU; either ‘0’, ‘1-49′, ’50-249′,’250-499’ or ‘500+’. | \n
\n\n| Image URL | \nA URL link to an image of the SKU in question. Any images used should be cached on your system. | \n
\n\n| Allowed Customisations | \nA semi-colon (;) separated list of allowed customisations for this SKU. There are three types: ‘print’ (multi colour print), ‘print_1colour’ (single colour print), ’embroidery’ (embroidery). | \n
\n\n| Allowed Positions | \nA semi-colon (;) separated list of allowed positions for this SKU. Please click here for a full list of position codes. | \n
\n\n
\n
Pricing Feed
\nThis feed contains the specific pricing for your account for each SKU. As this feed contains pricing information you may not wish to disclose, it can be downloaded via a unique secure link provided in your account area. This feed only needs to be downloaded when your pricing levels change. The csv columns are listed below:
\n\n\n\n| Column Name | \nDescription | \n
\n\n\n\n| SKU | \nThe SKU code. This is the key part that needs to passed to the API to order a product. | \n
\n\n| Price | \nThe actual price we charge you for the SKU, taking account of any custom pricing levels. Prices are in GBP and exclude VAT. | \n
\n\n| VAT Rate | \nThe VAT rate that will be applied to each SKU. | \n
\n\n
\n
Position Code Feed
\nThis feed lists all available position codes, together with the maximum width available in each position.
\nDelivery Destinations Feed
\nThis feed lists all available delivery destinations as well as the associated delivery charges we will charge you.
\n","_postman_id":"29281218-2870-4cc8-89fe-e23b5c23df36"},{"name":"Billing","item":[],"id":"5b737780-fc24-46cb-983a-4980f94bd328","description":"Payment options:
\n\n- BACS/Cheque (Invoiced monthly)
\n
\nAll invoices are sent via email to the billing contact listed on your account.
\nBACS/Cheque (Invoiced monthly) Payment Option
\nWith this option, an invoice will automatically be sent on the 7th of each month for the previous months sales. Payment should then be made within 7 days.
\nView All Invoices
\nAll invoices generated can be viewed here and downloaded in PDF format.
\n","_postman_id":"5b737780-fc24-46cb-983a-4980f94bd328"},{"name":"Account Options","item":[],"id":"b69477f8-4c0e-4142-9fca-b96b6b768bc9","description":"The Clothes2order API account area provides several options to update information stored with us, as well as view a full and complete history of all orders submitted through the API.
\nView Full Order History
\nAll orders generated through your API account can be viewed in detail here. Click an order number to view what was selected for a particular order. Any order issues which may be preventing your order being dispatched will also be listed here.
\n\nThe information you gave when signing up for an API account (name, email, website, billing contact details etc) can all be updated from this page.
\nChange Account Password
\nYou can update your account password here at any time. Please ensure you protect your password at all times as someone with access to your account can access your API key.
\nView Current API Settings
\nAPI settings associated with your account can be viewed here. Please note the settings in this section are not user-editable, so to discuss any changes please contact our API team
\n","_postman_id":"b69477f8-4c0e-4142-9fca-b96b6b768bc9"}],"id":"5fa03aae-9fb6-4d36-b751-b6c6f96a7e5c","description":"Once your API account is approved, you will be able to log in to your API account online. The Clothes2order API account area is a powerful tool allowing you to manage all aspects of your API account.
\nPlease use the links on the left to view more about the various sections of your API account in more detail.
\nTo log into your API account on the main Clothes2order site, please click here
\n","_postman_id":"5fa03aae-9fb6-4d36-b751-b6c6f96a7e5c"},{"name":"Technical Docs","item":[{"name":"HTTP Headers","item":[{"name":"Placing an Order","item":[],"id":"3c85ff45-15f7-4273-b8a5-0b8108754ac9","description":"This page details the technical specification for posting an order to the Clothes2order API. There are no further steps required to place an order; once you submit a request as detailed below, the order is instantly generated on our system ready for processing.
\nCommon problems
\nINSIDE BACK NECK PRINTED LABEL
\nInside back next printed labels can be assigned to your order by attaching a customisation in position code 18. Only one printed label customisation can be used per order, but of course the same printed label customisation can be used on multiple items. The customisation used can only be a single colour print, maximum width 12cm and is only available on selected product types (mainly t-shirts and polo shirts). Inside back neck prints are charged at a much lower rate than standard printing applications; to see your price simply download the pricing data feed in your account. More information on this service is available here.
\nCUSTOMISATION LIMITS
\nThere are no system limits on the number of products or customisations that can be placed on an order. Although we limit Clothes2order users to 6 customisations on our main site, there are no limits to how many customisations you can attach to a garment via the API.
\nADDRESS REQUIREMENTS
\nPlease note that we require a state or province for delivery to the USA, Canada, and Australia. This is because shipping addresses in these countries are not complete without a state or province. If you do not provide a state or province, your order may be delayed.
\nEircode is the national postcode system in Ireland. An Eircode is a unique 7-character code consisting of letters and numbers. Each Eircode consists of a 3-character routing key to identify the area and a 4-character unique identifier for each address. A typical Eircode might read A65 F4E2
\nWe use Irish postcodes “Eircode” to help us deliver your order to the correct address. If you do not provide a valid Irish postcode, your order may be delayed.
\nYou can check the validity of an Irish postcode on the Eircode website: https://www.eircode.ie/.
\nPlace Order API Endpoint
\nThe API endpoint for placing an order is:
\nhttps://www.clothes2order.com/api/v1/orders
\nPost XML Fields
\n<xml>\n <api_key>Your API Key</api_key>\n <order>\n <order_id>123456</order_id>\n <order_notes><![CDATA[Any extra information here]]></order_notes>\n <delivery_method>standard</delivery_method>\n </order>\n <customer>\n <name>Name Here</name>\n <email>email@email.com</email>\n <telephone>0161123456</telephone>\n <taxId>Tax id, required for delivery to some countries</taxId>\n </customer>\n <address class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <delivery_name>Name</delivery_name>\n <company_name>Quayside Clothing Ltd</company_name>\n <address_line_1>Unit 9 Wheel Forge Way</address_line_1>\n <address_line_2>Trafford Park</address_line_2>\n <city>Manchester</city>\n <postcode>M17 1EH</postcode>\n <country>United Kingdom</country>\n </address>\n <products>\n <product>\n <sku>594-117-15</sku>\n <quantity>2</quantity>\n <logos>\n <logo>\n <unique_id>TEST_02</unique_id>\n <file><![CDATA[https://dl.dropboxusercontent.com/u/111/1.png]]></file>\n <position>3</position>\n <width>8</width>\n <type>print</type>\n </logo>\n <logo>\n <unique_id>TEST_03</unique_id>\n <file><![CDATA[https://dl.dropboxusercontent.com/u/111/2.png]]></file>\n <position>5</position>\n <width>12</width>\n <type>print</type>\n </logo>\n </logos>\n </product>\n <product>\n <sku>594-117-14</sku>\n <quantity>1</quantity>\n <logos>\n <logo>\n <unique_id>TEST_04</unique_id>\n <file><![CDATA[https://dl.dropboxusercontent.com/u/111/3.png]]></file>\n <position>5</position>\n <width>10</width>\n <type>embroidery</type>\n </logo>\n <logo>\n <unique_id></unique_id>\n <file><![CDATA[https://dl.dropboxusercontent.com/u/111/4.png]]></file>\n <position>9</position>\n <width>25</width>\n <type>print_1colour</type>\n </logo>\n </logos>\n </product>\n </products>\n</xml>\n\n
\nPost JSON Fields
\n{\n \"api_key\": \"Your API Key\",\n \"order\": {\n \"order_id\": \"123456\",\n \"order_notes\": \"Any extra information here\",\n \"delivery_method\": \"standard\"\n },\n \"customer\": {\n \"name\": \"Name Here\",\n \"email\": \"email@email.com\",\n \"telephone\": \"0161123456\",\n \"taxId\": \"Tax id, required for delivery to some countries\"\n },\n \"address\": {\n \"delivery_name\": \"Name\",\n \"company_name\": \"Quayside Clothing Ltd\",\n \"address_line_1\": \"Unit 9 Wheel Forge Way\",\n \"address_line_2\": \"Trafford Park\",\n \"city\": \"Manchester\",\n \"postcode\": \"M17 1EH\",\n \"country\": \"United Kingdom\"\n },\n \"products\": {\n \"product\": [\n {\n \"sku\": \"594-117-15\",\n \"quantity\": \"2\",\n \"logos\": {\n \"logo\": [\n {\n \"unique_id\": \"TEST_02\",\n \"file\": \"https:\\/\\/dl.dropboxusercontent.com\\/u\\/111\\/1.png\",\n \"position\": \"3\",\n \"width\": \"8\",\n \"type\": \"print\"\n },\n {\n \"unique_id\": \"TEST_03\",\n \"file\": \"https:\\/\\/dl.dropboxusercontent.com\\/u\\/111\\/2.png\",\n \"position\": \"5\",\n \"width\": \"12\",\n \"type\": \"print\"\n }\n ]\n }\n },\n {\n \"sku\": \"594-117-14\",\n \"quantity\": \"1\",\n \"logos\": {\n \"logo\": [\n {\n \"unique_id\": \"TEST_04\",\n \"file\": \"https:\\/\\/dl.dropboxusercontent.com\\/u\\/111\\/3.png\",\n \"position\": \"5\",\n \"width\": \"10\",\n \"type\": \"embroidery\"\n },\n {\n \"unique_id\": \"\",\n \"file\": \"https:\\/\\/dl.dropboxusercontent.com\\/u\\/111\\/4.png\",\n \"position\": \"9\",\n \"width\": \"25\",\n \"type\": \"print_1colour\"\n }\n ]\n }\n }\n ]\n }\n}\n\n
\n\n\n\n| Node | \nDescription | \n
\n\n\n\n| api_key | \nYour API key provided to you when you sign up to use our API. | \n
\n\n| order->order_id | \nYour generated order id from your ordering system. This is recorded against the order on our system. | \n
\n\n| order->order_notes | \nAny additional comments related to the order you wish to pass through (optional). | \n
\n\n| order->delivery_method | \nThe delivery method for this order; standard options here are ‘standard’, ‘4day’ or ‘express’. | \n
\n\n| order->is_blank | \nIf this is an order without customisation, set this to ‘yes’ or ‘1’ (optional). Default is ‘no’. Blank products should not be ordered on the same order as customised products. | \n
\n\n| order->individual_bags | \nIf you would like each item bagging in an individual poly bag, set this to ‘yes’ or ‘1’ (optional). Default is ‘no’. There is a charge applicable for this service; the charge can be found in the pricing data feed in your account. More information on this service is available here. | \n
\n\n| customer->name | \nThe name of the customer. | \n
\n\n| customer->email | \nThe email address of the customer. By default, the Clothes2order API will not send any emails to the customer. | \n
\n\n| customer->telephone | \nThe telephone number of the customer. | \n
\n\n| customer->taxId | \nA tax identifier for the recipient. required for delivery to some countries, if required and not provided the order will be placed on hold | \n
\n\n| address->delivery_name | \nThe name to appear on the delivery address, if not set, customer->name will be used (optional). | \n
\n\n| address->company_name | \nThe company name to appear on the delivery address (optional). | \n
\n\n| address->address_line_1 | \nThe first line of the delivery address. | \n
\n\n| address->address_line_2 | \nThe second line of the delivery address. | \n
\n\n| address->city | \nThe postal city of the delivery address. | \n
\n\n| address->county | \nThis is not needed for UK addresses, but for international addresses you can add a county/state here (optional). | \n
\n\n| address->postcode | \nThe post code of the delivery address. | \n
\n\n| address->country | \nThe delivery country. Please see our delivery page for a list of countries we can deliver to. | \n
\n\n| products->product->sku | \nThe unique SKU code for the product selected. Please see the data feeds page for more information about our downloadable csv files. | \n
\n\n| products->product->quantity | \nThe quantity of the above SKU to order. The same SKU can be used multiple times if different customisations are required on each. | \n
\n\n| products->product->logos->logo->unique_id | \nIf you have customisations that can be purchased multiple times on different orders, setting a unique id will prevent the API having the pull the logo file each time an order is placed (optional). In addition, once the setup charge has been paid for a customisation in the specified size, using the same unique_id will automatically ensure you are not charged a setup charge again for that customisation (assuming the size has not changed). | \n
\n\n| products->product->logos->logo->file | \nThe full URL of the artwork file. This must be set or the order will not be accepted, even if the unique_id is set and the file has been used before. The file should be as you wish it to be produced and adhear to our standard artwork guidelines | \n
\n\n| products->product->logos->logo->position | \nThe position code for where the customisation should be placed. See the position codes page for a full list of position codes. | \n
\n\n| products->product->logos->logo->width | \nWidth image should be produced in cm. If not set or greater than the maximum size for a position, the maximum size will be used. See the position codes page for a full list of maximum sizes. | \n
\n\n| products->product->logos->logo->type | \nEither ‘print’ (multi colour print), ‘print_1colour’ (single colour print) or ’embroidery’ (embroidery). | \n
\n\n
\n
Response XML Fields
\nThe API will respond with XML once an order is submitted; please see below for details.
\n<xml>\n <status>\n <code class='preserveHtml' class='preserveHtml' class='preserveHtml'>OK</code>\n <msg>Data accepted from Your Company Name. API Mode: LIVE</msg>\n </status>\n <order_details>\n <order_id>999000</order_id>\n <net_order_value>26.06</net_order_value>\n <gross_order_value>31.27</gross_order_value>\n <est_dispatch_date>13/11/2013</est_dispatch_date>\n </order_details>\n <warnings>\n <warning>Your postcode is not a valid UK postcode</warning>\n <warning>Current stock levels are below the ordered quantity for sku 203-1-13</warning>\n </warnings>\n</xml>\n\n
\nResponse JSON Fields
\nThe API will respond with JSON once an order is submitted; please see below for details.
\n{\n \"status\": {\n \"code\": \"OK\",\n \"msg\": \"Data accepted from Your Company Name. API Mode: LIVE\"\n },\n \"order_details\": {\n \"order_id\": \"999000\",\n \"net_order_value\": \"26.06\",\n \"gross_order_value\": \"31.27\",\n \"est_dispatch_date\": \"13\\/11\\/2013\"\n },\n \"warnings\": {\n \"warning\": [\n \"Your postcode is not a valid UK postcode\",\n \"Current stock levels are below the ordered quantity for sku 203-1-13\"\n ]\n }\n}\n\n
\n\n\n\n| Node | \nDescription | \n
\n\n\n\n| status->code | \nEither ‘OK’ or ‘ERROR’. If a fatal error is reported here, the order will not be accepted. You can also check the HTTP response code header; ‘OK’ returns 200, ‘ERROR’ returns 400. | \n
\n\n| status->msg | \nThe associated success or error message. | \n
\n\n| order_details->order_id | \nThe Clothes2order order number for the placed order. | \n
\n\n| order_details->net_order_value | \nThe net cost you have been charged for the order. | \n
\n\n| order_details->gross_order_value | \nThe gross cost you have been charged for the order. | \n
\n\n| order_details->est_dispatch_date | \nThe estimated dispatch date for your order. | \n
\n\n| warnings->warning | \nAny warning messages about your order will be displayed here. | \n
\n\n| test_msgs->msg | \nIf you are running the API in test mode, testing results will be displayed here. | \n
\n\n
\n
This page details the technical specification for checking the status of an order to the Clothes2order API. Once an order is placed, you can query our system to retrieve information about the current order status.
\nFetch Order API Endpoint
\nThe API endpoint for checking the status of an order is:
\nhttps://www.clothes2order.com/api/v1/orders/fetch
\nPost XML Fields
\n<xml>\n <api_key>yourkey</api_key>\n <order>\n <your_order_id>YOURORDERID123456</your_order_id>\n <c2o_order_id>999000</c2o_order_id>\n </order>\n</xml>\n\n
Post JSON Fields
\n{\n \"api_key\": \"yourkey\",\n \"order\": {\n \"your_order_id\": \"YOURORDERID123456\",\n \"c2o_order_id\": \"999000\"\n }\n}\n\n
\n\n\n\n| Node | \nDescription | \n
\n\n\n\n| api_key | \nYour API key. | \n
\n\n| order->your_order_id | \nThe order id you wish you query. Either this or ‘c2o_order_id’ should be specified. | \n
\n\n| order->c2o_order_id | \nThe Clothes2order order id you wish to query. Either this or ‘your_order_id’ should be specified. | \n
\n\n
\n
Response XML Fields
\nThe API will respond with XML once a fetch request is submitted; please see below for details.
\n<xml>\n <status>\n <code class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>OK</code>\n <msg>Data accepted from Your Company Name. API Mode: LIVE</msg>\n </status>\n <order_details>\n <c2o_order_id>999000</c2o_order_id>\n <your_order_id>123456</your_order_id>\n <net_order_value>26.06</net_order_value>\n <gross_order_value>31.27</gross_order_value>\n <est_dispatch_date>13/11/2013</est_dispatch_date>\n <order_status>Dispatched</order_status>\n <shipped_by>Interlink</shipped_by>\n <tracking_link><![CDATA[http://www.full-courier-tracking-link.com/]]></tracking_link>\n <progress_images>\n <progress_image><![CDATA[http://www.clothes2order.com/progressimage1.jpg]]></progress_image>\n <progress_image><![CDATA[http://www.clothes2order.com/progressimage2.jpg]]></progress_image>\n </progress_images>\n <order_issues>\n <issue>\n <reason>Customer: Position not possible</reason>\n <date_added>23/01/2014</date_added>\n </issue>\n <issue>\n <reason>Customer: Artwork / Garment Colour Clash</reason>\n <date_added>24/01/2014</date_added>\n </issue>\n </order_issues>\n </order_details>\n</xml>\n\n
\nResponse JSON Fields
\nThe API will respond with JSON once a fetch request is submitted; please see below for details.
\n{\n \"status\": {\n \"code\": \"OK\",\n \"msg\": \"Data accepted from Your Company Name. API Mode: LIVE\"\n },\n \"order_details\": {\n \"c2o_order_id\": \"999000\",\n \"your_order_id\": \"123456\",\n \"net_order_value\": \"26.06\",\n \"gross_order_value\": \"31.27\",\n \"est_dispatch_date\": \"13\\/11\\/2013\",\n \"order_status\": \"Dispatched\",\n \"shipped_by\": \"Interlink\",\n \"tracking_link\": \"http:\\/\\/www.full-courier-tracking-link.com\\/\",\n \"progress_images\": {\n \"progress_image\": [\n \"http:\\/\\/www.clothes2order.com\\/progressimage1.jpg\",\n \"http:\\/\\/www.clothes2order.com\\/progressimage2.jpg\"\n ]\n },\n \"order_issues\": {\n \"issue\": [\n {\n \"reason\": \"Customer: Position not possible\",\n \"date_added\": \"23\\/01\\/2014\"\n },\n {\n \"reason\": \"Customer: Artwork \\/ Garment Colour Clash\",\n \"date_added\": \"24\\/01\\/2014\"\n }\n ]\n }\n }\n}\n\n
\n\n\n\n| Node | \nDescription | \n
\n\n\n\n| status->code | \nEither ‘OK’ or ‘ERROR’. If a fatal error is reported here, the request will not be processed. You can also check the HTTP response code header; ‘OK’ returns 200, ‘ERROR’ returns 400. | \n
\n\n| status->msg | \nThe associated success or error message. | \n
\n\n| order_details->c2o_order_id | \nThe Clothes2order order number for the placed order. | \n
\n\n| order_details->your_order_id | \nYour order number passed when the order was placed. | \n
\n\n| order_details->net_order_value | \nThe net cost you have been charged for the order. | \n
\n\n| order_details->gross_order_value | \nThe gross cost you have been charged for the order. | \n
\n\n| order_details->est_dispatch_date | \nThe estimated dispatch date for your order. | \n
\n\n| order_details->order_status | \nThe current status of the order. Typical values include ‘Processing Order’, ‘Dispatched’ and ‘On Hold’. | \n
\n\n| order_details->shipped_by | \nThe delivery method used to send the order (node included if the current status is ‘Dispatched’) . | \n
\n\n| order_details->tracking_link | \nThe direct courier tracking link for the order (node included if the current status is ‘Dispatched’). | \n
\n\n| progress_images->progress_image | \nA list of images that have been taken of the order in progress, if any are available. For more information about this unique feature, please click here | \n
\n\n| order_issues->issue->reason | \nIn the rare cases there are any outstanding issues with your order, these will be shown here. By clicking an order number in your online order history you can then view full details of the issue. | \n
\n\n| order_issues->issue->date_added | \nThe date the above outstanding order issue was recorded. | \n
\n\n
\n
Important Notes
\nChecking the status of orders is not currently rate limited, but is subject to reasonable fair use limits. The status of an order is unlikely to change more than once a day. Orders are dispatched by 8pm BST Monday to Friday, so we would recommend checking the status of an order after this time and caching the results for 24 hours. Once an order reaches the ‘Dispatched’ status, the status will not change from this point so should not be queried again.
\n","_postman_id":"83e541a1-dd18-475f-96f6-b877f1e7f4ae"},{"name":"Position Codes","item":[],"id":"88597ff5-1979-456a-8baa-362d6e103379","description":"All customisations sent via the ordering API require a position code to indicate where they should be printed or embroidered. The full list of position codes is below. All positions are stated as worn.
\nImportant Notes
\nThe maximum width for printing is 30cm, the maximum width for embroidery is 25cm. Any embroidery designs submitted via the API with a width greater than 25cm will automatically have the size reduced to 25cm by the API.
\n","_postman_id":"88597ff5-1979-456a-8baa-362d6e103379"},{"name":"Code Examples","item":[],"id":"e9d16249-192f-4033-af8f-717a0b34654b","description":"StartFragment
\nThe Clothes2order API is designed to be simple to integrate into any existing platform. Below is a basic PHP code example to get you started. The example is available to suit both XML and JSON formats (click the option in the top right to change your preference).
\nPHP Post Order XML Example
\n/*\nAPI Post Order Test Script\nClothes2order.com\n*/\n//Defines\ndefine('API_KEY','your-api-key');\ndefine('API_URL','https://www.clothes2order.com/api/v1/orders');\n//Set your data here\n$post_data = '\n<xml>\n <api_key>' . API_KEY . '</api_key>\n <order>\n <order_id>123456</order_id>\n <order_notes><![CDATA[Any extra information here]]></order_notes>\n <delivery_method>standard</delivery_method>\n </order>\n <customer>\n <name>Name Here</name>\n <email>email@email.com</email>\n <telephone>0161123456</telephone>\n </customer>\n <address class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml' class='preserveHtml'>\n <delivery_name>Name</delivery_name>\n <company_name>Quayside Clothing Ltd</company_name>\n <address_line_1>Unit 9 Wheel Forge Way</address_line_1>\n <address_line_2>Trafford Park</address_line_2>\n <city>Manchester</city>\n <postcode>M17 1EH</postcode>\n <country>United Kingdom</country>\n </address>\n <products>\n <product>\n <sku>594-117-15</sku>\n <quantity>2</quantity>\n <logos>\n <logo>\n <unique_id>TEST_02</unique_id>\n <file><![CDATA[http://www.clothes2order.com/images/c2o_new_2013/layout/carousel/15.jpg]]></file>\n <position>3</position>\n <width>8</width>\n <type>print</type>\n </logo>\n <logo>\n <unique_id>TEST_03</unique_id>\n <file><![CDATA[http://www.clothes2order.com/images/c2o_new_2013/layout/carousel/14.jpg]]></file>\n <position>5</position>\n <width>12</width>\n <type>print</type>\n </logo>\n </logos>\n </product>\n <product>\n <sku>1316-1-13</sku>\n <quantity>1</quantity>\n <logos>\n <logo>\n <unique_id>TEST_04</unique_id>\n <file><![CDATA[http://www.clothes2order.com/images/c2o_new_2013/layout/carousel/32.jpg]]></file>\n <position>5</position>\n <width>10</width>\n <type>embroidery</type>\n </logo>\n <logo>\n <unique_id></unique_id>\n <file><![CDATA[http://www.clothes2order.com/images/c2o_new_2013/layout/carousel/16.jpg]]></file>\n <position>9</position>\n <width>25</width>\n <type>print_1colour</type>\n </logo>\n </logos>\n </product>\n </products>\n</xml>\n';\n//Post data to the API\n$ch = curl_init(API_URL);\ncurl_setopt($ch, CURLOPT_HTTPHEADER,\n array('Content-Type: application/xml',\n 'Accept: application/xml'\n )\n);\ncurl_setopt($ch, CURLOPT_HEADER, 0);\ncurl_setopt($ch, CURLOPT_POST, 1);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);\ncurl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);\ncurl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);\n$ch_result = curl_exec($ch);\n$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n//Get response\n$obj = simplexml_load_string($ch_result);\n//Check HTTP status\nif ($http_code == 200) {\n //All OK\n echo 'All seems OK: ' . $obj->status->msg . \"<br />\\n\";\n //Lets echo some values\n echo 'Clothes2order order ID: ' . $obj->order_details->order_id . \"<br />\\n\";\n echo 'This order has cost you: £' . $obj->order_details->net_order_value . \"<br />\\n\";\n echo 'Estimated dispatch date: ' . $obj->order_details->est_dispatch_date . \"<br />\\n\";\n if (sizeof($obj->warnings->warning) > 0) {\n foreach ((array)$obj->warnings->warning as $warning) {\n echo 'Warning: ' . $warning . \"<br />\\n\";\n }\n }\n if (sizeof($obj->test_msgs->msg) > 0) {\n foreach ((array)$obj->test_msgs->msg as $test_msg) {\n echo 'Test message: ' . $test_msg . \"<br />\\n\";\n }\n }\n} elseif ($http_code == 400) {\n //There was an error\n echo 'Error occured: ' . $obj->status->msg . \"<br />\\n\";\n}\nexit;\n?>\n\n
\nPHP Post Order JSON Example
\n/*\nAPI Post Order Test Script\nClothes2order.com\n*/\n//Defines\ndefine('API_KEY','your-api-key');\ndefine('API_URL','https://www.clothes2order.com/api/v1/orders');\n//Set your data here\n$post_data = '\n{\n \"api_key\": \"' . API_KEY . '\",\n \"order\": {\n \"order_id\": \"123456\",\n \"order_notes\": \"Any extra information here\",\n \"delivery_method\": \"standard\"\n },\n \"customer\": {\n \"name\": \"Name Here\",\n \"email\": \"email@email.com\",\n \"telephone\": \"0161123456\"\n },\n \"address\": {\n \"delivery_name\": \"Name\",\n \"company_name\": \"Quayside Clothing Ltd\",\n \"address_line_1\": \"Unit 9 Wheel Forge Way\",\n \"address_line_2\": \"Trafford Park\",\n \"city\": \"Manchester\",\n \"postcode\": \"M17 1EH\",\n \"country\": \"United Kingdom\"\n },\n \"products\": {\n \"product\": [\n {\n \"sku\": \"594-117-15\",\n \"quantity\": \"2\",\n \"logos\": {\n \"logo\": [\n {\n \"unique_id\": \"TEST_02\",\n \"file\": \"http:\\/\\/www.clothes2order.com\\/images\\/c2o_new_2013\\/layout\\/carousel\\/15.jpg\",\n \"position\": \"3\",\n \"width\": \"8\",\n \"type\": \"print\"\n },\n {\n \"unique_id\": \"TEST_03\",\n \"file\": \"http:\\/\\/www.clothes2order.com\\/images\\/c2o_new_2013\\/layout\\/carousel\\/14.jpg\",\n \"position\": \"5\",\n \"width\": \"12\",\n \"type\": \"print\"\n }\n ]\n }\n },\n {\n \"sku\": \"1316-1-13\",\n \"quantity\": \"1\",\n \"logos\": {\n \"logo\": [\n {\n \"unique_id\": \"TEST_04\",\n \"file\": \"http:\\/\\/www.clothes2order.com\\/images\\/c2o_new_2013\\/layout\\/carousel\\/32.jpg\",\n \"position\": \"5\",\n \"width\": \"10\",\n \"type\": \"embroidery\"\n },\n {\n \"unique_id\": \"\",\n \"file\": \"http:\\/\\/www.clothes2order.com\\/images\\/c2o_new_2013\\/layout\\/carousel\\/16.jpg\",\n \"position\": \"9\",\n \"width\": \"25\",\n \"type\": \"print_1colour\"\n }\n ]\n }\n }\n ]\n }\n}\n';\n//Post data to the API\n$ch = curl_init(API_URL);\ncurl_setopt($ch, CURLOPT_HTTPHEADER,\n array('Content-Type: application/json',\n 'Accept: application/json'\n )\n);\ncurl_setopt($ch, CURLOPT_HEADER, 0);\ncurl_setopt($ch, CURLOPT_POST, 1);\ncurl_setopt($ch, CURLOPT_POSTFIELDS, $post_data);\ncurl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);\ncurl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);\ncurl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);\n$ch_result = curl_exec($ch);\n$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\ncurl_close($ch);\n//Get response\n$obj = json_decode($ch_result);\n//Check HTTP status\nif ($http_code == 200) {\n //All OK\n echo 'All seems OK: ' . $obj->status->msg . \"<br />\\n\";\n //Lets echo some values\n echo 'Clothes2order order ID: ' . $obj->order_details->order_id . \"<br />\\n\";\n echo 'This order has cost you: £' . $obj->order_details->net_order_value . \"<br />\\n\";\n echo 'Estimated dispatch date: ' . $obj->order_details->est_dispatch_date . \"<br />\\n\";\n if (sizeof($obj->warnings->warning) > 0) {\n foreach ((array)$obj->warnings->warning as $warning) {\n echo 'Warning: ' . $warning . \"<br />\\n\";\n }\n }\n if (sizeof($obj->test_msgs->msg) > 0) {\n foreach ((array)$obj->test_msgs->msg as $test_msg) {\n echo 'Test message: ' . $test_msg . \"<br />\\n\";\n }\n }\n} elseif ($http_code == 400) {\n //There was an error\n echo 'Error occured: ' . $obj->status->msg . \"<br />\\n\";\n}\nexit;\n?>\n\n
\nYou can download these example files on our code resources page.
\n","_postman_id":"e9d16249-192f-4033-af8f-717a0b34654b"},{"name":"Resources","item":[],"id":"3ff7d097-16b2-4e99-9daf-ccfe0d103712","description":"Below are some free to download resources designed to aid any development work with the Clothes2order API. Check back soon for more downloads.
\n\n","_postman_id":"3ff7d097-16b2-4e99-9daf-ccfe0d103712"}],"id":"d18c7ad1-de0a-4392-a89f-885ca4908d0c","description":"There are various HTTP headers that can be used when sending data to the Clothes2order API and in addition, different response headers can be sent back to you depending on the request.
\n\nThe key header to note here is the ‘Accept’ header; this allows you to use the API with either XML or JSON.
\n\n\n\n| Parameter | \nOptions | \nDefault | \nDescription | \n
\n\n\n\n| Accept | \napplication/xml or application/json | \napplication/xml | \nDetermines whether XML or JSON should be used. | \n
\n\n| Test-Mode | \ntrue or false | \nfalse | \nOnce you have been set live on the API, you can use this header to force a test transaction. | \n
\n\n
\n
Instead of having to check the OK/ERROR status in the content of the response, the HTTP header code can also be checked to determine if a request was successful or not.
\n\n\n\n| HTTP Response Code | \nDescription | \n
\n\n\n\n| 200 | \nRequest was received successfully. | \n
\n\n| 400 | \nThere was an error with your request. In the case of order submission, your order hasn’t been accepted. | \n
\n\n
\n
The Clothes2order API is built in a RESTful way and is designed to be powerful yet simple to use. The API supports both XML and JSON requests from the same URL sets and uses HTTP error codes appropriately in responses.
\nAuthentication is built around a single API key; it’s important you do not disclose this key as anyone in possession of it will be able to place orders using your account.
\nTo aid with development, the API has a testing mode (the default for new users) so requests can be sent and the responses validated without the need to place live orders.
\nFor detailed technical information about the various areas of the API, please click the links on the left.
\n","_postman_id":"86febe87-7d42-4feb-8d5d-a25467a489f1"},{"name":"API Features","item":[{"name":"Silent Fulfilment","item":[],"id":"966cbba1-cf8c-4633-bbf3-37621db25066","description":"Many clothing APIs on the market are quite basic. You can submit an order, but then you have to redirect the user to someone else’s payment pages to complete the order on a different URL. Not only is this a poor experience for your customer but it makes your site look very amateurish. For any serious business, an API set up like this doesn’t offer an acceptable solution.
\nThe Clothes2order API is different! You send your orders to us electronically without your customer needing to leave your website. You retain complete control of your own order process.
\n\n- Set up your website however you please; any ecommerce platform can work with our API.
\n- Charge whatever you like for your items.
\n- Take payment via whichever method you choose.
\n- We’ll send your order directly to your customer, with a custom packing slip as standard.
\n- We won’t market to or contact your customer directly.
\n
\nIf this sounds like the API for you, click here to sign up now.
\n","_postman_id":"966cbba1-cf8c-4633-bbf3-37621db25066"},{"name":"Custom Pricing","item":[],"id":"1a01ad84-0301-43d5-8092-5c5133c291bc","description":"The Clothes2order API supports very flexible pricing levels. The price we can offer you will be largely based on the volume of orders you are sending and for simplicity, we will charge you a flat rate price per SKU. These prices are based on our existing pricing structure; for example you might be set on “price break 3 + 5%” for products and “price break 2 – 10%” for application charges.
\n![](\"https://content.pstmn.io/016e2f9b-1d3d-45c0-8147-063eac282f62/aW1hZ2UucG5n\")
\n\nYou can view your current pricing structure by logging in to your account and all your exact SKU prices can be viewed by downloading your pricing data feed from your account.
\nBy default, all new users start with:
\n\n- Price break 2 for products and applications
\n- FREE set up for all printed logos (save money instantly versus placing the order through our normal site)
\n
\nIf you’d like to discuss alternative pricing levels simply contact our API team and we can offer alternative prices based on your sales volume.
\nIf this sounds like the API for you, click here to sign up now.
\n","_postman_id":"1a01ad84-0301-43d5-8092-5c5133c291bc"},{"name":"Dispatch Features","item":[],"id":"d8c8281d-aac8-442c-8f1a-a349a1dfd0e3","description":"There are several features provided as standard to API users to make the dispatch and delivery of goods to your end user as seamless as possible.
\nCustom Packing Slip
\nWe print your logo, address and contact details on the packing slip for your order as standard. Rather than having a Clothes2order branded packing slip, this really helps promote your brand and improve the experience of your customers.
\nPlease note packing slips are printed in black and white, so please consider this when supplying us your logo.
\nDirect Courier Tracking Link
\nThe majority of orders sent from Clothes2order to UK destinations are dispatched via Interlink Express courier. They provide excellent delivery tracking and a 1 hour time slot for delivery. Once your order is dispatched, you can query our API to obtain a direct link to the tracking information for the order which you can then send to your customer.
\nWe also provide direct tracking links when international orders are dispatched; these are sent via UPS.
\nIf this sounds like the API for you, click here to sign up now.
\n","_postman_id":"d8c8281d-aac8-442c-8f1a-a349a1dfd0e3"},{"name":"Default Customisations","item":[],"id":"9fd7a448-74bb-44ef-bc9b-c882b68c8eb3","description":"Want to brand the clothing you supply? Although we do not offer a relabeling service, for a low per item fee, Clothes2order can add a default customisation to all your items. For example, you could have your company logo printed in the back neck position of all your garments. Since these need to be single colour prints, we can offer them more cheaply than standard printing applications.
\nIf this service is of interest, please contact our API team for more details.
\n","_postman_id":"9fd7a448-74bb-44ef-bc9b-c882b68c8eb3"},{"name":"Order Progress Images","item":[],"id":"2d15653a-96d8-4231-a38c-0fe506ba8a1f","description":"One of the features our customers love best is our order progress images. During production, we email our customers an image of their order actually in production. Some examples of these images are shown below:
\n![](\"https://www.clothes2order.com/images/order_images/1390636918130.jpg\")
\n\n![](\"https://www.clothes2order.com/images/order_images/1390898192659.jpg\")
\n\nThis unique feature is available to API users as standard! When requesting the current order status via our API, any order progress image URLs will be listed. You can then send these to your customer or link to them from your site as you wish. The images are not branded or watermarked byClothes2order so can fit seamlessly into your site or customer correspondence.
\nIf this sounds like the API for you, click here to sign up now.
\n*Please note we do not guarantee to produce a progress image for every order.
\n","_postman_id":"2d15653a-96d8-4231-a38c-0fe506ba8a1f"}],"id":"59d96b42-df58-4f0b-bb31-a0f7f034e128","description":"The Clothes2order API offers an unparalleled array of great features. As well as a huge product range, automated billing and a simple yet powerful API interface, our API offers many other features as standard to all users.
\nTo discover more about our additional API features, please click the links on the left hand side.
\nIf this sounds like the API for you, click here to sign up now.
\n","_postman_id":"59d96b42-df58-4f0b-bb31-a0f7f034e128"},{"name":"API FAQs","item":[],"id":"5031800a-80ae-4115-b824-ca11028054d5","description":"Below are a list of questions and answers regarding our API which aren’t covered in other areas of the documentation.
\nHow is pricing set for products and applications?
\nFor API pricing we offer a single price per each SKU based on standard Clothes2order pricing. To view more information about Clothes2order pricing in general, please click here.?We offer custom pricing to API users depending on your sales volume. Please click here to view more about custom pricing.
\nHow are delivery charges calculated?
\nDelivery charges are based on our standard delivery pricing. You can also select express dispatch through the API; charges for this are based on our standard express pricing.
\nWhat countries can I send orders to?
\nA full list of countries we ship to is shown on our delivery information page. Please note all orders are charged in GBP regardless of where they are shipped. Express delivery options are only available to UK destinations.
\nWhat customisation types can I order through the API?
\nWe only accept images through the API; i.e. printed logos or embroidered logos as we classify them on the main Clothes2order site. You can still order just text, but you’ll need to create an image file of your text rather than just passing individual lines of text as we can on the Clothes2order front end site. The reason for this is that to pass individual text lines, fonts, colours etc would hugely complicate the API so to keep it simple we just ask for a single image file per design. We do not support individual names and numbers in the same way as on the Clothes2order front end site, however you can still pass a different image customisation containing a name and/or number as a standard design to achieve the same effect if you wish.
\nDo you send customisation proofs?
\nNo, we do not send proofs for API orders as standard. The reason for this is that we don’t communicate with your end customer so we take this process out of the order. Our expert team will create the artwork as you have specified when the order is created.
\nWhat support is available for the API?
\nThe API documentation provided here is very comprehensive and should cover any questions you might have. To use our API you will need some technical knowledge, or access to someone who does. Although we can’t do the integration for you, our API team is on hand to offer support via our dedicated API contact form. Please note we’re unable to offer phone support to API users.
\nDo you process returns on behalf of API users?
\nNo. You define your own returns policy and handle that as you wish via your own site. If you wish to accept customer returns, the item is then yours to do with as you please (resell for example). As such, we require a contact address from all API users which will be printed on your packing slip.
\nCan the API be used to order blank items?
\nYes! Simply add items without customisation to your API order and make sure you set the is_blank flag when placing your order.
\n","_postman_id":"5031800a-80ae-4115-b824-ca11028054d5"}]} ![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/1.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/2.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/3.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/4.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/5.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/6.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/7.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/8.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/9.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/11.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/12.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/13.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/14.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/15.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/16.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/17.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/18.jpg\")
![](\"https://www.clothes2order.com/images/c2o_new_2013/layout/checkout/positions/19.jpg\")