Products

Batch Relay publishes provider-neutral canonical products. The catalog response contains families for browsing and products for ordering. Every product has a stable ID, immutable fulfillment revision, explicit physical output, quantity meaning, options, and prepared-media contract. Fetch the catalog instead of hardcoding a provider SKU, image shape, or product alias:

GET /v1/catalog/products
GET /v1/catalog/products/{product_id}

Submit that revision with prepared media for your chosen product. Batch Relay does not crop or silently alter order artwork. The public API can copy an external source into managed fulfillment storage, and the optional template renderer can create composed artwork before fulfillment.

Start with the catalog

The catalog is the live authority for availability, lifecycle status, revisions, and option values. A family groups related immutable variants. Orders and quotes still use a concrete product ID and revision. If a page and the catalog disagree, use the catalog response.

Category	Products
Prints	4 × 5, 4 × 6, 5 × 5, 5 × 7, 3.5 × 5, 8 × 10, 12 × 18, 16 × 20, wallet sheets
Keepsakes	Magnets, buttons, keychains, bag tags, contemporary plaques
Trader products	Trader cards and trader-card magnets
Designed output	Memory Mates and magazine covers rendered into ordinary print artwork
Digital delivery	Digital Download catalog record, not a print-order API fulfillment route

Prepared assets

Every order item has an assets array. Each asset has a semantic role and exactly one source: an external HTTPS url or an authorized asset_id. Creating a quote copies URL sources into private managed fulfillment storage; an asset_id reuses already-managed bytes without another copy. Immutable dimensions, size, format, and SHA-256 metadata are resolved from the stored bytes rather than trusted from caller hints. Examples of roles include artwork, background, individual, team, logo, front, and back. The catalog is authoritative for which roles are required, each role’s aspect ratio, and rotation_policy. A role appears exactly once. A URL only needs to remain available through successful quote creation; submission and fulfillment use the quote-owned managed snapshot. The product examples below focus on the product-specific portion of an item. An external URL source can be supplied as:

{
  "role": "artwork",
  "url": "https://cdn.example.com/orders/ord_123/artwork.jpg",
  "printed_file_name": "ord_123-artwork.jpg"
}

For an existing managed asset, replace url with asset_id. URL-backed quote requests require an Idempotency-Key; retries reuse the same immutable copy. Compatibility checks remain read-only and use any supplied diagnostic metadata without downloading the URL.

Orientation and provider placement

Every asset role defaults to rotation_policy: "fixed": prepare the exact orientation and ratio listed on its product page. Batch Relay rejects a wrong canonical role or ratio; it never edits the image to make it fit. Only a role published with rotation_policy: "allowed" accepts the reciprocal ratio. Standard prints and active Memory Mates allow rotation. When a template is used, its renderer produces a final ordinary print artifact in the selected output geometry before the fulfillment step. For the current WHCC adapter, native AutoRotate is enabled only for an explicitly allowed role. It is disabled for fixed roles. The adapter preflights placement against the verified provider node and rejects a fit that would require more than a 1.25% center crop. This is provider-side placement reconciliation, not an image transformation.

Prints

Product	Output per quantity	Prepared asset
Print variants	1 print	`artwork`; exact ratio comes from the selected size variant
Wallet sheet	4 wallets	`artwork` `5:7`

Keepsakes

Product	Output per quantity	Prepared asset roles
4 × 5 Magnet	1 magnet	`artwork` `4:5`
3-inch Photo Button	1 button	`artwork` `1:1`
Acrylic Keychains	1 keychain	Small `4:5`; large `7:5`; both require `front` and `back`
Metal Keychain	1 keychain	`front`, `back` `15:11`
Bag Tags	1 bag tag	Small and large use separate two-sided contracts
Contemporary Plaques	1 plaque	5 × 7 uses `4:5`; 8 × 10 uses `7:9`

Trader products

Product	Output per quantity	Prepared asset roles
Trader Cards	12 cards	`front` `11:15`, `individual` `9:7`, `back` `15:11`
Trader Card Magnets	2 magnets	`front` `21:16`, `back` `7:5`

Designed output

template_requirement controls whether an order may use prepared artwork directly:

optional means the product can use prepared artwork directly or a succeeded Batch Relay render. Standard photographic prints use this policy.
required means the product must use the asset_id from a succeeded Batch Relay render and the matching template_render_id. A raw URL or unrelated managed asset is rejected.
unsupported means the product has no supported template workflow.

The designed products below all use template_requirement: "required". Their rendered artwork remains attached to the Memory Mate or magazine-cover order record, then fulfills through its pinned standard-print target. See Template renders for the render workflow.

Product	Output per quantity	Prepared asset
5 × 7 Memory Mate	1 print	`artwork` `5:7` or `7:5`
8 × 10 Memory Mate	1 print	`artwork` `4:5` or `5:4`
Magazine Cover, 8 × 10	1 print	`artwork` `4:5`

Digital delivery

Digital Download is a live catalog record, but the public print-order API does not create or deliver digital entitlements. Do not put it in a print-order request.

Pricing and availability are explicit

Catalog unit_costs include every known option combination. unit_cost_cents is null with pricing_status: "unverified" until Batch Relay establishes a provider PPU; zero is reserved for a real zero price. A measured amount is marked sandbox_quote or production_verified. These are provider costs per physical unit, not studio retail prices. Catalog support means Batch Relay recognizes and validates the canonical contract. Provider compatibility and hosted quote availability are separate decisions. Check the catalog and the quote/compatibility response for the environment in which you will order; do not infer paid-production readiness from the existence of a product page.

Start

Core Concepts

Product reference

Start with the catalog

Prepared assets

Orientation and provider placement

Prints

Keepsakes

Trader products

Designed output

Digital delivery

Pricing and availability are explicit

​Start with the catalog

​Prepared assets

​Orientation and provider placement

​Prints

​Keepsakes

​Trader products

​Designed output

​Digital delivery

​Pricing and availability are explicit

Start with the catalog

Prepared assets

Orientation and provider placement

Prints

Keepsakes

Trader products

Designed output

Digital delivery

Pricing and availability are explicit