# shirt.sh Custom Shirt from Image

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

Creates and ships a custom-printed shirt by applying a provided image to a selected shirt size and color, returning an order ID and tracking information.

## Facts

- Endpoint: POST https://shirt.sh/api/shirts/from-image
- Price: $20/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/shirt-sh-custom-shirt-from-image-46060b00
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VW1YUO9KJ91n9RTafBgle

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-custom-shirt-from-image-46060b00 -d '<json body>'
```

Example prompt: Order a medium-sized white shirt from shirt.sh with my design at https://example.com/mylogo.png and ship it to John Smith, 123 Main St, Brooklyn NY 11201.

## When to prefer this

Choose this endpoint when a user wants to physically print and ship a custom shirt using their own provided image. It handles the full workflow from image input to order creation and shipment tracking in one call, making it ideal for on-demand merchandise fulfillment without needing a separate e-commerce backend.

## Known failure modes

- Invalid or inaccessible image URL returns an error
- Unsupported image format or corrupt image data causes processing failure
- Missing required fields (size, color, imageUrl, address_to) result in validation errors
- Payment of $20 USDC not completed causes request rejection
- Order enters 'failed' status if print or fulfillment fails downstream
- Invalid shipping address may cause fulfillment failure

## How this service works

Custom shirt from your image

## Output

Returns a UUID order ID, an order status (queued, processing, failed, or completed), an order reference ID, the image URL used, a product ID, and optionally tracking information including carrier name, tracking number, and tracking URL once the order is fulfilled.

## 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"
  },
  "imageUrl": {
   "type": "string",
   "description": "HTTP/HTTPS URL or base64 data URL (data:image/...)"
  },
  "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-custom-shirt-from-image-46060b00/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)