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"
}

Get Rate

POST /api/v1/getLabelPrice.json

Calculates the shipping rate for a package without creating a label. This is useful for estimating costs before fulfilling an order.

HTTP request

POST https://api.taygapod.com/api/v1/getLabelPrice.json

Request Body

{
    "address_to_zip": "01453",
    "weight": "0.1" // lb
}

Response

{
    "status": "success",
    "price": 4.34
}

Create Label

POST /api/v1/createLabel.json

Generate a shipping label for an order. You must provide your own order_id to track this label against your internal records.
Note: The "From" address (return address) is static and pre-configured by your Tayga manager.

HTTP request

POST https://api.taygapod.com/api/v1/createLabel.json

Request Body

{
  "order_id": "ORD-998877",
  "weight": 0.5,
  "address_to": {
    "first_name": "John",
    "last_name": "Doe",
    "address1": "123 Main St",
    "city": "Beverly Hills",
    "region": "CA",
    "zip": "90210",
    "country": "US",
    "phone": "555-0199"
  }
}

Response

{
  "status": "success",
  "data": {
    "id": 275,
    "order_id": "ORD-998877",
    "tracking_number": "9400100000000000000000",
    "price": 4.50,
    "label": "https://api.taygapod.com/storage/labels/label_123.pdf"
  }
}

Get Label

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

Retrieve an existing label by your specific order_id provided during creation.

HTTP request

GET https://api.taygapod.com/api/v1/getLabel/{order_id}.json

Response example

{
  "status": "success",
  "data": {
    "id": 275,
    "order_id": "ORD-998877",
    "tracking_number": "9400100000000000000000",
    "label": "https://api.taygapod.com/storage/labels/label_123.pdf"
  }
}

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