SwiftPOD API

1. Overview

The SwiftPOD API v1 is a API service for viewing the product catalog, inventory, getting order details and completing orders for our printing and fulfillment services.

Requests are made using standard GET and POST. All responses are JSON.

Once you sign up for an account, you will be provided with a real API key (In your account settings).

2. Authentication

This API uses normal method for authentication (API Keys in params). Your private API keys should be used as the password.

If you are currently logged in account settings, you can go to [Setting] -> [API Credentials] and get API Keys there.

All requests must be made over HTTPS.

3. Rate Limit

150 requests per 10 seconds, Block for 1 minute

4. Get Order Information (Trackings)

```java HelloWorld.java
"trackings": [
      {
          "primary": true,  // true: default tracking
          "tracking_number": "ABC123",
          "tracking_url": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=ABC123",
          "carrier": "USPS",
          "created_at": "2022-05-23T09:22:31.000000+00:00",
          "status": null
      }
  ],
```

5. Print Area Definition

Key	Explanation
front	Input this key if you wish to print on the front area.
back	Input this key if you wish to print on the back area.
inner_neck_label	Located on the inside of the garment, usually containing vital details like the country of manufacturing origin, original garment size, and material specifics. You only need to upload your logo, and the remaining required information will be automatically updated based on the specifications of the shirt.
outer_neck_label	Located on the outside of the garment underneath the collar. This area offers ample space for incorporating branding elements such as logos, slogans, or additional information.
pocket	Use this key if you wish to print on the pocket area of the product.
above_pocket	This key is for printing on the area above the pocket of the product.
left_sleeve	Use this key if you intend to print on the left sleeve of the garment.
right_sleeve	Use this key if you intend to print on the right sleeve of the garment.
3df	This key indicates the use of UV 3D printing method on the front area of the product.
emb_front_small	This key signifies embroidering on the front area of the product.
emb_left_chest	This key signifies embroidering on the left chest area of the product.
bleed_mug	This key indicates the use of print on bleed mug. Print area "bleed_mug" is exclusively available for specific SKUs mentioned here
dtf_f	This key signifies printing on the front area of the product using Direct-to-Film technology.
dtf_b	This key signifies printing on the back area of the product using Direct-to-Film technology.
dtf_pocket	This key signifies printing on the pocket area of the product using Direct-to-Film technology.
dtf_above_pocket	This key signifies printing on the above pocket area of the product using Direct-to-Film technology.
maxprint	This key signifies printing on the largest area of the mug, covering almost the entire surface.Print area "maxprint" is exclusively available for specific SKUs mentioned here.
poster	This key indicates the use of print on poster. Print area "poster" is exclusively available for specific SKUs mentioned here here.

6. Available SKUs for Bleed Mug Print Area

View the list

#	SKU	Product Name
1	MUGS1W11O	MUGS / WHITE / 11 oz
2	MUGS1W15O	MUGS / WHITE / 15 oz
3	MUHC1C11O	MUHC / BLUE / 11 oz
4	MUHC1C15O	MUHC / BLUE / 15 oz
5	MUHC1R11O	MUHC / RED / 11 oz
6	MUHC1R15O	MUHC / RED / 15 oz
7	MUHC1P11O	MUHC / PINK / 11 oz
8	MUHC1P15O	MUHC / PINK / 15 oz
9	MUHCH711O	MUHC / LIGHT GREEN / 11 oz
10	MUHCH715O	MUHC / LIGHT GREEN / 15 oz
11	MUHC5R11O	MUHC / MAROON / 11 oz
12	MUHC5R15O	MUHC / MAROON / 15 oz
13	MUHC1O11O	MUHC / ORANGE / 11 oz
14	MUHC1O15O	MUHC / ORANGE / 15 oz
15	MUHC1Y11O	MUHC / YELLOW / 11 oz
16	MUHC1Y15O	MUHC / YELLOW / 15 oz
17	MUHC1B11O	MUHC/ BLACK / 11 oz
18	MUHC1B15O	MUHC/ BLACK / 15 oz
19	MUHC4N11O	MUHC/ LIGHT BLUE / 11 oz
20	MUHC4N15O	MUHC /LIGHT BLUE / 15 oz
21	MUHC1D11O	MUHC / COBALT /11 oz
22	MUHC1D15O	MUHC / COBALT / 15 oz
23	MUHCQ311O	MUHC / LIGHT YELLOW /11 oz
24	MUHCQ315O	MUHC/ LIGHT YELLOW / 15 oz
25	CMUG1B11O	CMUG/ BLACK / 11 oz

7. Available SKUs for Maxprint Print Area

View the list

| # | SKU | Product Name | |----|------------|----------------------------| | 1 | MUHC1B11O | MUHC / BLACK / 11 oz | | 2 | MUHC1B15O | MUHC / BLACK / 15 oz | | 3 | MUHC1C11O | MUHC / BLUE / 11 oz | | 4 | MUHC1C15O | MUHC / BLUE / 15 oz | | 5 | MUHC1O11O | MUHC / ORANGE / 11 oz | | 6 | MUHC1O15O | MUHC / ORANGE / 15 oz | | 7 | MUHC1P11O | MUHC / PINK / 11 oz | | 8 | MUHC1P15O | MUHC / PINK / 15 oz | | 9 | MUHC1R11O | MUHC / RED / 11 oz | | 10 | MUHC1R15O | MUHC / RED / 15 oz | | 11 | MUHC1Y11O | MUHC / YELLOW / 11 oz | | 12 | MUHC4N11O | MUHC / LIGHT BLUE / 11 oz | | 13 | MUHC4N15O | MUHC / LIGHT BLUE / 15 oz | | 14 | MUHC5R11O | MUHC / MAROON / 11 oz | | 15 | MUHCH711O | MUHC / LIGHT GREEN / 11 oz | | 16 | MUGS1C11O | MUGS / BLUE / 11 oz | | 17 | MUGS1C15O | MUGS / BLUE / 15 oz | | 18 | MUGS1W11O | MUGS / WHITE / 11 oz | | 19 | MUGS1W15O | MUGS / WHITE / 15 oz |

8. Available SKUs for Poster Print Area

View the list

| # | SKU | Product Name | |----|------------|----------------------------| | 1 | POST1W303 | Satin Paper Poster / WHITE / 30x30 Inches | | 2 | POST1W242 | Satin Paper Poster / WHITE / 24x24 Inches | | 3 | POST1W161 | Satin Paper Poster / WHITE / 16x16 Inches | | 4 | POST1W324 | Satin Paper Poster / WHITE / 32x48 Inches | | 5 | POST1W243 | Satin Paper Poster / WHITE /24x36 Inches| | 6 | POST1W162 | Satin Paper Poster / WHITE / 16x24 Inches | | 7 | POST1W121 | Satin Paper Poster / WHITE / 12x18 Inches | | 8 | POST1W081 | Satin Paper Poster / WHITE / 8x12 Inches |

AUTHORIZATION Bearer token