Print on Demand Fulfillment API
The Orders API allows you to create, view and cancel orders in Tayga’s fulfillment system. All examples below use JSON over HTTPS and are scoped only to order operations you requested.
Base URL
All endpoints below are relative to the production base URL:
Authentication
The Tayga Orders API uses HTTP Basic authentication. Each client receives a username and password. All requests must be sent over HTTPS.
Headers
Authorization: Basic <base64(username:password)>Content-Type: application/jsonAccept: application/json
# Example: get order
curl -u YOUR_USERNAME:YOUR_PASSWORD \
"https://api.taygapod.com/api/v1/orders/{order_id}.json"
Create an order
POST /api/v1/orders.jsonCreates a new order in Tayga. The structure below matches the production payload used by the system.
{
"id": "{order_id}",
"address_to": {
"address1": "812 Maple Ridge Lane",
"address2": "Apt 4B",
"city": "Fairview",
"zip": "92704",
"country": "US",
"region": "CA",
"first_name": "Elena",
"last_name": "Rowan",
"email": "elena.rowan@example.test",
"phone": "555-314-8920"
},
"address_from": {
"address1": "1450 Tayga Parkway",
"address2": "Suite 210",
"city": "Northbridge",
"zip": "60521",
"country": "US",
"region": "IL",
"company": "Tayga LLC",
"email": "support@tayga.test",
"phone": "555-867-2045"
},
"shipping_label": {
"carrier": "USPS",
"service": "GROUND ADVANTAGE",
"tracking_number": "420497889200190370692517497753",
"shipping_label": "https://easypost-files.s3.us-west-2.amazonaws.com/files/postage_label/20250908/e80cbd723c09d44ca0aba1101f57df2ca7.png"
},
"shipping": {
"carrier": "USPS",
"service": "GROUND ADVANTAGE"
},
"items": [
{
"id": "{item-id}",
"sku": "5001-BLACK-L",
"preview_files": {
"front": "",
"back": ""
},
"print_files": {
"front": "",
"back": ""
},
"quantity": 1,
"printing_technique": "DTF"
}
]
}
{
"status": "success",
"id": "{order_id}",
"reference_id": "{Tayga system Order ID}"
}
{
"status": "failed",
"errors": [
{
"message": "Order ID consist special characters!",
"code": 404
}
]
}
Get the order
GET /api/v1/orders/{order_id}.jsonRetrieves a single order by its customer-defined ID.
{
"id": "{Customer order ID}",
"reference_id": "{order ID in Tayga system}",
"status": "created",
"address_to": {
"address1": "812 Maple Ridge Lane",
"address2": "Apt 4B",
"city": "Fairview",
"zip": "92704",
"country": "US",
"region": "CA",
"first_name": "Elena",
"last_name": "Rowan",
"email": "elena.rowan@example.test",
"phone": "555-314-8920"
},
"address_from": {
"address1": "1450 Tayga Parkway",
"address2": "Suite 210",
"city": "Northbridge",
"zip": "60521",
"country": "US",
"region": "IL",
"company": "Tayga LLC",
"email": "support@tayga.test",
"phone": "555-867-2045"
},
"shipping": {
"carrier": "USPS",
"service": "GROUND ADVANTAGE",
"tracking_number": "",
"tracking_url": "",
"shipped_time": "2020-11-04"
},
"items": [
{
"id": "{item-id}",
"sku": "5000-BLACK-L",
"preview_files": {
"front": "",
"back": ""
},
"print_files": {
"front": "",
"back": ""
},
"quantity": 1,
"printing_technique": "DTF"
}
]
}
{
"status": "failed"
}
Cancel the order
POST /api/v1/order/{order_id}/cancel.jsonCancels an existing order by its customer-defined ID. Depending on production status, cancellation may fail if the order is already shipped.
{
"status": "success",
"message": "Order is canceled successfully."
}
{
"status": "failed",
"message": "Order not found"
}
Locations
| Location | Type |
|---|---|
| front_regular | Front · Regular Print Area |
| front_logo | Front · Logo Size |
| front_oversize | Front · Oversize Print |
| front_full | Front · Full Print |
| back_regular | Back · Regular Print Area |
| back_logo | Back · Logo Size |
| back_oversize | Back · Oversize Print |
| back_full | Back · Full Print |
Printing Techniques
- DTG
- DTF
- UV PRINTING
- SUBLIMATION
Shipping
| Carrier | Service |
|---|---|
| USPS | Ground Advantage |
| GOFO | Parcel Pickup |