# shirt.sh AI Shirt Design & Purchase

> shirt.sh AI Shirt Design & Purchase is a paid API for AI agents from shirt.sh, paid per call via x402, $20/call, status unknown (last checked 2026-09-13).

Generates a custom AI-designed shirt from a text prompt and places a purchase order for physical delivery

## Facts

- Endpoint: POST https://shirt.sh/api/shirts
- Price: $20/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shirt-sh-ai-shirt-design-purchase-417224ad
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tEvu892FIzLARkoloH2nT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability shirt-sh-ai-shirt-design-purchase-417224ad -d '<json body>'
```

Example prompt: Order me a medium-sized white shirt from shirt.sh with an AI-generated design of a galaxy-surfing astronaut cat, and ship it to Jane Doe at 123 Main St, Brooklyn, NY 11201.

## When to prefer this

Use this endpoint when you want to both generate and purchase a custom AI-designed shirt in a single API call. It handles the full loop from AI image generation to physical order placement and fulfillment, making it ideal for autonomous agents that need end-to-end merchandise creation without separate design and checkout steps.

## Known failure modes

- Invalid or missing prompt — design generation fails with a failed status
- Unsupported size or color value — order cannot be created
- Incomplete shipping address — order placement fails
- Payment of $20 USDC not received — request rejected
- Downstream fulfillment failure — status returns failed with no tracking info
- Malformed address_to object — validation error returned

## How this service works

AI-generated shirt design + purchase

## Output

Returns a UUID order ID, order status (queued/processing/failed/completed), an image URL of the AI-generated shirt design, a product ID, an order ID, and optionally tracking info with carrier, tracking number, and tracking URL once the item ships.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "size": {
   "enum": [
    "S",
    "M",
    "L",
    "XL",
    "2XL",
    "3XL",
    "4XL",
    "5XL"
   ],
   "type": "string"
  },
  "color": {
   "enum": [
    "Black",
    "White"
   ],
   "type": "string"
  },
  "prompt": {
   "type": "string"
  },
  "address_to": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "id",
  "status"
 ],
 "properties": {
  "id": {
   "type": "string",
   "format": "uuid",
   "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
  },
  "status": {
   "enum": [
    "queued",
    "processing",
    "failed",
    "completed"
   ],
   "type": "string"
  },
  "orderId": {
   "type": "string"
  },
  "imageUrl": {
   "type": "string",
   "description": "HTTP/HTTPS URL or base64 data URL (data:image/...)"
  },
  "productId": {
   "type": "string"
  },
  "trackingInfo": {
   "anyOf": [
    {
     "type": "object",
     "required": [
      "carrier",
      "trackingNumber",
      "trackingUrl"
     ],
     "properties": {
      "carrier": {
       "type": "string"
      },
      "trackingUrl": {
       "type": "string"
      },
      "trackingNumber": {
       "type": "string"
      }
     },
     "additionalProperties": false
    },
    {
     "type": "null"
    }
   ]
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/shirt-sh-ai-shirt-design-purchase-417224ad/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from shirt.sh](https://www.zero.xyz/host/shirt.sh/llms.txt)