Tayga Orders API · v1

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:

https://api.taygapod.com

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/json
  • Accept: application/json
Example cURL
# 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.json

Creates a new order in Tayga. The structure below matches the production payload used by the system.

HTTP request
POST  https://api.taygapod.com/api/v1/orders.json
Request example
{
  "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"
    }
  ]
}
Successful response
{
  "status": "success",
  "id": "{order_id}",
  "reference_id": "{Tayga system Order ID}"
}
Failed response
{
  "status": "failed",
  "errors": [
    {
      "message": "Order ID consist special characters!",
      "code": 404
    }
  ]
}

Get the order

GET /api/v1/orders/{order_id}.json

Retrieves a single order by its customer-defined ID.

HTTP request
GET  https://api.taygapod.com/api/v1/orders/{order_id}.json
Response example
{
  "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"
    }
  ]
}
Failed response
{
  "status": "failed"
}

Cancel the order

POST /api/v1/order/{order_id}/cancel.json

Cancels an existing order by its customer-defined ID. Depending on production status, cancellation may fail if the order is already shipped.

HTTP request
POST  https://api.taygapod.com/api/v1/order/{order_id}/cancel.json
Successful response
{
  "status": "success",
  "message": "Order is canceled successfully."
}
Failed response
{
  "status": "failed",
  "message": "Order not found"
}

Locations

Location Type
front_regularFront · Regular Print Area
front_logoFront · Logo Size
front_oversizeFront · Oversize Print
front_fullFront · Full Print
back_regularBack · Regular Print Area
back_logoBack · Logo Size
back_oversizeBack · Oversize Print
back_fullBack · Full Print

Printing Techniques

  • DTG
  • DTF
  • UV PRINTING
  • SUBLIMATION

Shipping

Carrier Service
USPS Ground Advantage
GOFO Parcel Pickup