Products

The v1 API supports a narrow set of Batch Relay product aliases. These aliases are provider-neutral; Batch Relay maps them to the active print provider internally.

Alias	Description	Required image ratio
photo-print-5x7	5x7 photo print.	5:7 or 7:5
photo-print-8x10	8x10 photo print.	4:5 or 5:4
photo-print-16x20	16x20 photo print.	4:5 or 5:4
wallets	Wallet print set.	5:7 or 7:5
magnet	Magnet print.	5:7 or 7:5
magnet-and-5x7	Combined magnet plus 5x7 print.	5:7 or 7:5

Image validation

Every item must include a public image.url. Batch Relay fetches a bounded header range from the image and validates dimensions before creating a provider import.

• Supported formats: JPEG, PNG, WebP.
• Ratio tolerance: 0.01 from the expected width / height ratio.
• Rotated images are accepted when listed above.
• Invalid or unreadable images return 422 image_invalid.
• Ratio mismatches return 422 image_aspect_ratio_mismatch.

Example item:

{
  "product": "photo-print-5x7",
  "quantity": 1,
  "image": {
    "url": "https://images.batchrelay.com/team-5x7.jpg"
  }
}