Get Started

Welcome to the TeeAllover API documentation. This guide will help you integrate with our print-on-demand platform.

🔑 How to Get Your StoreCode and API Credentials

Step 1: Login to TeeAllover

Visit TeeAllover Pro and login to your account. You can get the StoreCode ( Example: MPO ) as image below.

Step 2: Navigate to Account Settings

Once logged in, go to: Menu → Edit Account → Settings

Or directly visit: Account Settings

Step 4: Get Your Credentials

• API Username: Use the same StoreCode value as your username
• API Password: Get From Account Settings

Authentication

All API requests require authentication using Basic Auth with your TeeAllover credentials.

Authorization Type

Basic Auth - Base64 encoded credentials

# Authentication Example
curl -X GET \
  -H "Authorization: Basic <base64_encode(MPO:your_password)>" \
  "https://api.teeallover.com/t/Tee/v1//Store"

Testing Your Credentials

You can test your authentication by making a simple request to the Store endpoint:

# Test Authentication
curl -X GET \
  -H "Authorization: Basic <base64_encode(MPO:your_password)>" \
  "https://api.teeallover.com/t/Tee/v1/MPO/Store"

If authentication is successful, you'll receive your store information. If not, you'll get a 401 Unauthorized response.

Overview Flow

Complete workflow from store creation to order fulfillment and tracking.

Products

Get all available TeeAllover products with their options and specifications.

Get Map Files

Get map product examples or available positions (extra positions) for a specific product.

Query Parameters

Stores

Retrieve all stores associated with your account.

Create Store

Create a new store in your account.

Request Body

Response

Parameters

Create Order

Create a new order with line items and shipping information.

Request Body

Response

Order Parameters

Get Order

Retrieve order details by store name and order name.

Query Parameters

Response

Update Order Info

Update order information including customer details and shipping address.

Query Parameters

Update Parameters

Request Body

Update Order Item

Update specific line items within an order.

Parameters

Request Body

Response

Request Cancel

Cancel specific line items from an order and process refunds. If your order locked to production, you may need supporter from TeeAllover.

Request Body

Parameters

Response

Response Fields

Status Values

• trash: Item is canceled and moved to trash
• hold: Item is put on hold
• normal: Item status is reset to normal (empty status)

Error Responses

{
    "success": false,
    "error": [
        "LineItem 123456789 not found",
        "LineItem 987654321 is not fulfilled"
    ]
}

Common Error Messages

• "LineItem {item_id} not found": The specified line item doesn't exist
• "LineItem {item_id} is not fulfilled": The line item doesn't have a valid invoice ID
• "Invalid new status": The new_status parameter has an invalid value

Business Rules

• Only items with valid invoice IDs can be canceled
• Seller can only cancel items they own
• Refunds are automatically processed for canceled items
• Email notifications are sent to relevant parties

Request Fulfillment

Request invoice creation for specific line items to fulfill orders.

Request Body

Parameters

Response

Response Fields

Error Responses

Common error messages:

• "LineItem {item_id} not found": The specified line item doesn't exist
• "LineItem {item_id} already has invoice": The line item is already fulfilled
• "Your balance is not enough": Insufficient balance to create invoice
• "No valid items found": No items could be processed

Business Rules

• Only items without existing invoices can be fulfilled
• Seller must have sufficient balance to cover the invoice total
• Seller can only fulfill items they own
• Invoice is created immediately upon successful request
• Balance is deducted automatically upon invoice creation

Get Tracking

Retrieve tracking numbers for shipped orders.

Response

Webhooks

Manage webhooks to receive real-time notifications about order updates.

Available Topics

Get Webhooks Response

Create Webhook Request

Create Webhook Response

Update Webhook Request

Update Webhook Response

Delete Webhook Request

Delete Webhook Response

Design Error Webhook Payload

When a design error occurs, your webhook endpoint will receive a POST request with the following payload:

Design Error Fields

Error Codes

The TeeAllover API uses the following error codes: