{"openapi":"3.1.0","info":{"title":"Attraction Product API","description":"Public, read-only product catalogue for Attraction: SKUs, colours, sizes, live\ninventory, MSRP price brackets, images and decoration compatibility for the\nEthica, Initial and Jameo brands. No API key is required for public data.\n\n## Authentication\n\nPublic catalogue data is open. An Attraction distributor account can also read\nits own net prices by sending an API key as\n`Authorization: Bearer attr_sk_…`; keys are created and revoked at\nhttps://www.attraction.com/api/keys/.\n\nA key returns the prices of the account it belongs to, and only those: the\nresponse echoes the tier it was served at in `pricing.priceTier`, which follows\nthe account's current tier rather than the tier held when the key was created.\nA key that is invalid or revoked answers 401 (`invalid_key`, `key_revoked`)\nrather than quietly returning MSRP, so an integration can never mistake public\npricing for its own.\n\n## Errors\n\nEvery error response is an RFC 9457 problem document served as\n`application/problem+json`. Branch on the `code` member, which is stable;\n`title` and `detail` are human-readable and may be reworded.\n\n## Rate limits\n\nCatalogue reads carry `RateLimit-Policy` and `RateLimit` headers\n(draft-ietf-httpapi-ratelimit-headers). The `default` policy allows 600\nrequests per 60 seconds per client address. Unverified API keys must pass\nthis address admission check before backend verification. Successfully verified\nkeys use the `keyed` application quota of 1200 requests\nper 60 seconds per key on detail and pricing routes. A fresh positive\nverification cache entry bypasses address admission; the first or expired-cache\nverification consumes address admission as well as a keyed request. The catalogue\nlist always uses the address policy. Response headers describe the keyed quota\nafter successful verification, otherwise the address policy. Limits are advisory and\napplied per API instance; a breach answers 429 with `Retry-After`.\n\n## Versioning and deprecation\n\nMajor versions live in the URL (`/v1`). Breaking changes ship as a new major\nversion (`/v2`) while the previous version keeps serving. Deprecations are\nannounced at least three months before their sunset date with `Deprecation`\n(RFC 9745), `Sunset` (RFC 8594) and a `Link` with `rel=\"deprecation\"`.\nAdditive changes — new fields, new endpoints — never bump the version.","version":"v1"},"externalDocs":{"url":"https://www.attraction.com/developers/","description":"Attraction developer documentation: errors, rate limits, versioning."},"servers":[{"url":"https://api.attraction.com","description":"Production public API"}],"components":{"schemas":{"Problem":{"type":"object","title":"Problem","description":"RFC 9457 problem detail. Every error response uses this shape and is served as `application/problem+json`.","required":["type","title","status","detail","instance","code"],"properties":{"type":{"type":"string","format":"uri","description":"Documentation anchor identifying the problem type. Stable across releases.","example":"https://www.attraction.com/developers/#error-product_not_found"},"title":{"type":"string","description":"Short human-readable summary of the problem type.","example":"Product not found"},"status":{"type":"integer","description":"HTTP status code, repeated for clients that only read the body.","example":404},"detail":{"type":"string","description":"Human-readable explanation of this occurrence. Never contains a stack trace.","example":"No product matches SKU NOPE in locale en-CA."},"instance":{"type":"string","description":"Path of the request that produced the problem.","example":"/v1/products/NOPE"},"code":{"type":"string","description":"Machine-readable error code. Branch on this rather than on `detail`.","enum":["route_not_found","method_not_allowed","invalid_request","unsupported_locale","invalid_sku","unauthorized","key_required","invalid_key","key_revoked","product_not_found","rate_limited","upstream_unavailable","internal_error"],"example":"product_not_found"}},"additionalProperties":true}},"headers":{"RateLimit":{"description":"Remaining quota (`r`) and seconds until the window resets (`t`) for the applied policy. See draft-ietf-httpapi-ratelimit-headers.","schema":{"type":"string"},"example":"\"default\";r=599;t=60"},"RateLimit-Policy":{"description":"Quota (`q`) and window length in seconds (`w`) of the applied policy. Catalogue lists, anonymous reads, and unverified credentials use `default` (600 per client address). Unverified keys must pass this admission check before backend verification. Successfully verified detail/pricing requests use `keyed` (1200 per key); a fresh positive verification cache bypasses address admission. The first or expired-cache verification consumes address admission as well as a keyed request. After successful verification the response reports the keyed application quota, sent as \"keyed\";q=1200;w=60.","schema":{"type":"string"},"example":"\"default\";q=600;w=60"},"Retry-After":{"description":"Seconds to wait before retrying.","schema":{"type":"integer"},"example":30},"Deprecation":{"description":"RFC 9745 date at which the resource became deprecated, as `@<unix seconds>`. Sent only on deprecated resources; see https://www.attraction.com/developers/#versioning-and-deprecation.","schema":{"type":"string"},"example":"@1788134400"},"Sunset":{"description":"RFC 8594 date after which the deprecated resource stops responding.","schema":{"type":"string"},"example":"Sat, 01 Aug 2026 00:00:00 GMT"},"WWW-Authenticate":{"description":"RFC 6750 challenge sent with every 401. Carries `error=\"invalid_token\"` when a key was presented and rejected, and no `error` parameter when no credentials were presented at all.","schema":{"type":"string"},"example":"Bearer realm=\"api.attraction.com\", error=\"invalid_token\""}},"responses":{"BadRequest":{"description":"The request was rejected. `code` names the rejected input.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-unsupported_locale","title":"Unsupported locale","status":400,"detail":"Locale de-DE is not supported. Use en-CA, en-US or fr-CA.","instance":"/v1/products","code":"unsupported_locale"}}}},"Unauthorized":{"description":"Credentials are missing or invalid.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-unauthorized","title":"Unauthorized","status":401,"detail":"A valid sync API key or service signature is required.","instance":"/v1/sync/products","code":"unauthorized"}}}},"KeyUnauthorized":{"description":"The API key is missing, malformed, unknown, or no longer active. The public catalogue never answers this without a key: it is the routes that report an account's own prices that require one.","headers":{"WWW-Authenticate":{"$ref":"#/components/headers/WWW-Authenticate"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-invalid_key","title":"Invalid API key","status":401,"detail":"This API key is not recognised. Check it was copied whole, or create a new one at https://www.attraction.com/api/keys/.","instance":"/v1/products/100386U","code":"invalid_key"}}}},"NotFound":{"description":"The requested resource does not exist.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-product_not_found","title":"Product not found","status":404,"detail":"No product matches SKU NOPE in locale en-CA.","instance":"/v1/products/NOPE","code":"product_not_found"}}}},"MethodNotAllowed":{"description":"The route exists but does not accept this method.","headers":{"Allow":{"description":"Methods the route accepts.","schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-method_not_allowed","title":"Method not allowed","status":405,"detail":"POST is not supported on /v1/products. This resource is read-only.","instance":"/v1/products","code":"method_not_allowed"}}}},"TooManyRequests":{"description":"The advisory rate limit was exceeded. See https://www.attraction.com/developers/#rate-limits.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"},"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-rate_limited","title":"Too many requests","status":429,"detail":"More than 600 requests were made in 60 seconds from this address.","instance":"/v1/products","code":"rate_limited"}}}},"BadGateway":{"description":"A downstream service could not be reached.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-upstream_unavailable","title":"Catalogue temporarily unavailable","status":502,"detail":"Product sync unavailable.","instance":"/v1/sync/products","code":"upstream_unavailable"}}}},"ServiceUnavailable":{"description":"The catalogue is temporarily unreachable. Retry later.","headers":{"Retry-After":{"$ref":"#/components/headers/Retry-After"}},"content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-upstream_unavailable","title":"Catalogue temporarily unavailable","status":503,"detail":"The product catalogue did not answer. Retry in a few seconds.","instance":"/v1/products","code":"upstream_unavailable"}}}},"InternalError":{"description":"Unexpected server error. The response never carries a stack trace.","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"},"example":{"type":"https://www.attraction.com/developers/#error-internal_error","title":"Internal server error","status":500,"detail":"The request could not be completed.","instance":"/v1/products","code":"internal_error"}}}}},"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"An Attraction API key, sent as `Authorization: Bearer attr_sk_…`. It returns the net prices of the account that owns it, at that account's current price tier. Keys are created and revoked at https://www.attraction.com/api/keys/."}}},"paths":{"/v1/health":{"get":{"operationId":"getV1Health","summary":"Health check","description":"Liveness probe for the public API. Not rate limited and never cached.","tags":["Service"],"responses":{"200":{"description":"Service health status.","content":{"application/json":{"schema":{"type":"object","required":["status","timestamp"],"properties":{"status":{"type":"string","enum":["ok"],"example":"ok"},"timestamp":{"type":"string","format":"date-time","example":"2026-08-24T12:00:00.000Z"}}},"example":{"status":"ok","timestamp":"2026-08-24T12:00:00.000Z"}}}},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"500":{"$ref":"#/components/responses/InternalError"}}}},"/v1/products":{"get":{"operationId":"getV1Products","summary":"List public products","description":"Returns public product summaries, clean API-provided categories with display order, and localized brand labels for the requested locale. Standard products include local images; Jameo and made-to-order products can use colorBlocks customization. Summaries leave out inventory, `descriptions.long`, the per-colour `material` and `pricing.sizes`; `GET /v1/products/{sku}` returns them, with inventory by colour and size. Each product carries `updatedAt` (last observed change to its catalog content) and the envelope carries `catalogUpdatedAt` (last observed change to which SKUs exist); both are null until such a change has been observed, and neither reflects inventory movement. The product detail's `inventoryUpdatedAt` dates the last stock change.","tags":["Products"],"parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en-CA","en-US","fr-CA"],"example":"en-CA"},"description":"Response locale. Defaults to en-CA."}],"responses":{"200":{"description":"Public product catalog.","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"}},"content":{"application/json":{"schema":{"type":"object","required":["locale","catalogUpdatedAt","products","categories","brands"],"properties":{"locale":{"type":"string","example":"en-CA"},"catalogUpdatedAt":{"type":["string","null"],"format":"date-time","description":"Last observed change to catalog composition — a SKU added or removed — at ingestion; null = no composition change observed since 2026-08-25. Edits to an existing product move that product's updatedAt, not this field.","example":"2026-08-25T14:30:00.000Z"},"products":{"type":"array","items":{"type":"object","required":["sku","slug","updatedAt","productName","descriptions","brand","customization","catalog","keywords","tag","minimumOrder","studio","pricing","images","colors"],"properties":{"sku":{"type":"string","example":"100386U"},"slug":{"type":"string","example":"100386u"},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Last observed change to catalog content at ingestion, excludes inventory; null = no change observed since 2026-08-25. Stock movements, price-list re-imports and any other re-ingest of identical content leave it unchanged. For the last stock change, read `inventoryUpdatedAt` from `GET /v1/products/{sku}`.","example":"2026-08-20T08:40:00.000Z"},"productName":{"type":"string","example":"Crewneck t-shirt"},"descriptions":{"type":"object","description":"Localized public product copy.","required":["tagline","short"],"properties":{"tagline":{"type":"string"},"short":{"type":"string"}}},"keywords":{"type":"array","items":{"type":"string"}},"brand":{"type":"string","example":"Ethica"},"customization":{"type":"object","required":["colorBlocks"],"properties":{"colorBlocks":{"type":"boolean","description":"True for products displayed with the custom color-block wheel.","example":false},"colorBlocksTagline":{"type":"string","description":"Optional public tagline for color-block products.","example":"Over 300 combinations"}}},"catalog":{"type":"object","required":["inspiration","category","for","fabrics"],"properties":{"inspiration":{"type":"array","items":{"type":"string"},"example":["Promotional"]},"category":{"type":["string","null"],"description":"The product's category. null when the product has no catalog classification.","example":"T-shirts"},"for":{"type":["string","null"],"description":"Who the product is cut for, such as Unisex or Woman. Empty for products without an audience, such as bags; null when the product has no catalog classification.","example":"Unisex"},"fabrics":{"type":"array","items":{"type":"string"},"description":"The product's fabrics. Empty when none is recorded.","example":["Jersey"]}}},"tag":{"type":"string","description":"Merchandising tag, such as Best seller. Empty when the product has none.","example":"Best seller"},"minimumOrder":{"type":"object","required":["quantity","description"],"properties":{"quantity":{"type":"number","example":36},"description":{"type":"string","example":"Minimum 36 decorated units. No minimum undecorated."}}},"studio":{"type":"object","required":["available"],"properties":{"available":{"type":"boolean","description":"Whether the public website can link to Studio for this product.","example":true}}},"pricing":{"type":"object","required":["currency","msrp"],"properties":{"currency":{"type":"string","example":"CAD"},"msrp":{"type":"array","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"designCredits":{"type":"object","description":"Free design credits included with the product. Present only on products that include them.","required":["included"],"properties":{"included":{"type":"number","example":8},"description":{"type":"string"},"descriptionShort":{"type":"string","description":"Compact form of `description`.","example":"8 free design credits included"}}}}},"images":{"type":"array","items":{"type":"object","required":["url","alt"],"properties":{"url":{"type":"string","format":"uri","example":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp"},"alt":{"type":"string","example":"Crewneck t-shirt"}}}},"colors":{"type":"array","items":{"type":"object","required":["id","name","swatches","colorFamilies","images"],"properties":{"id":{"type":"string","example":"0001"},"pms":{"type":"string","example":"White"},"name":{"type":"string","example":"White"},"swatches":{"type":"array","items":{"type":"string"},"example":["#FFFFFF"]},"colorFamilies":{"type":"array","description":"Colour families the swatches were classified into: usually one, several for multi-tone colours, empty when the colour has no swatch to classify (made-to-order placeholders) or none close enough to a family.","items":{"type":"object","required":["name","hex"],"properties":{"name":{"type":"string","description":"Family name in the response locale, such as Green or Vert.","example":"Green"},"hex":{"type":"string","description":"The family's display colour as #RRGGBB. This is the palette entry shared by every colour in the family, not this colour's own swatch.","example":"#2F8F46"},"sortIndex":{"type":"integer","minimum":0,"description":"Position in the complete colour-family palette, ordered with Studio's perceptual display algorithm. Lower values come first; the rank is independent of locale and product filtering. May be absent for historical families outside the current palette; show those after ranked families."}}},"example":[{"name":"White","hex":"#F8F8F2"}]},"images":{"type":"array","items":{"type":"string","format":"uri"}}}}}}}},"categories":{"type":"array","description":"Clean product categories and their display/sort order from the API.","items":{"type":"object","required":["name","order"],"properties":{"name":{"type":"string","example":"T-shirts"},"order":{"type":["number","null"],"description":"Display order, lowest first. null when the category has no set order; those categories come last, by name.","example":10}}}},"brands":{"type":"object","additionalProperties":{"type":"object","required":["name","url","description"],"properties":{"name":{"type":"string","example":"Ethica"},"url":{"type":"string","description":"Public brand URL. Empty when no brand page is published.","example":"https://www.attraction.com/en-ca/products/ethica/"},"description":{"type":"string"}}}}}},"example":{"locale":"en-CA","catalogUpdatedAt":"2026-08-25T14:30:00.000Z","products":[{"sku":"100386U","slug":"100386u","updatedAt":"2026-08-20T08:40:00.000Z","productName":"Crewneck t-shirt","descriptions":{"tagline":"Crewneck t-shirt, our best-selling t-shirt. Ethica made in Canada.","short":"Crewneck t-shirt in jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour, our best-selling t-shirt, wide colour range. Made in Canada."},"brand":"Ethica","customization":{"colorBlocks":false},"catalog":{"inspiration":["Promotional"],"category":"T-shirts","for":"Unisex","fabrics":["Jersey"]},"keywords":["t shirt","crewneck","ethica","made in canada","organic cotton"],"tag":"Best seller","minimumOrder":{"quantity":36,"description":"Minimum 36 decorated units. No minimum undecorated."},"studio":{"available":true},"pricing":{"currency":"CAD","msrp":[{"minQuantity":1,"maxQuantity":23,"price":30.5},{"minQuantity":24,"maxQuantity":99,"price":28},{"minQuantity":100,"maxQuantity":299,"price":26},{"minQuantity":300,"maxQuantity":499,"price":23.5}]},"images":[{"url":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp","alt":"Crewneck t-shirt"}],"colors":[{"id":"0001","pms":"White","name":"White","swatches":["#FFFFFF"],"colorFamilies":[{"name":"White","hex":"#F8F8F2","sortIndex":4}],"images":["https://www.attraction.com/assets/products/100386u/100386u-white.webp"]}]}],"categories":[{"name":"T-shirts","order":10},{"name":"Long sleeves","order":20}],"brands":{"Ethica":{"name":"Ethica","url":"https://www.attraction.com/en-ca/products/ethica/","description":"Timeless classics, made in Canada with sustainable fibres."}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/products/pricing":{"get":{"operationId":"getV1ProductsPricing","summary":"Get every product's price brackets for the authenticated account","description":"Returns the quantity price brackets of every product available in the requested locale, in one response, at the account's own price tier. This is the bulk counterpart of `/v1/products/{sku}/pricing`, and the endpoint to use for net prices across the whole catalogue — `GET /v1/products` stays MSRP-only. `currency` and `priceTier` are reported once on the envelope rather than repeated per product, and products are ordered by SKU. Like the per-product view it has no public representation: send an API key as `Authorization: Bearer attr_sk_…`, or a Studio session cookie; a request without credentials answers 401 `key_required`.","tags":["Products"],"security":[{"bearerKey":[]}],"parameters":[{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en-CA","en-US","fr-CA"],"example":"en-CA"},"description":"Response locale. Defaults to en-CA."}],"responses":{"200":{"description":"Price brackets for every available product, at the authenticated account's tier.","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"}},"content":{"application/json":{"schema":{"type":"object","title":"BulkPricing","required":["currency","priceTier","products"],"properties":{"currency":{"type":"string","example":"CAD"},"priceTier":{"type":"string","description":"The price tier every product below was priced at — the current tier of the account the credentials belong to.","example":"A3"},"products":{"type":"array","description":"Every product available in the requested locale, ordered by SKU.","items":{"type":"object","required":["sku","msrp"],"properties":{"sku":{"type":"string","example":"100386U"},"msrp":{"type":"array","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"net":{"type":"array","description":"The account's net brackets at the envelope's `priceTier`.","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"sizes":{"type":"array","description":"Every size the product is sold in, in size order, with its upcharge when it has one: the MSRP upcharge, plus the tier's net upcharge on an authenticated read. Omitted for products without sizes.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"XL"},"surcharge":{"type":"object","description":"Omitted when the size has no upcharge.","required":["msrp"],"properties":{"msrp":{"type":"number","example":2},"net":{"type":"number","example":1.5}}}}}}}}}}},"example":{"currency":"CAD","priceTier":"A3","products":[{"sku":"100386U","msrp":[{"minQuantity":36,"maxQuantity":99,"price":28}],"net":[{"minQuantity":36,"maxQuantity":99,"price":18.5}]},{"sku":"100387U","msrp":[{"minQuantity":36,"maxQuantity":99,"regularPrice":32,"price":27}],"net":[{"minQuantity":36,"maxQuantity":99,"regularPrice":21.5,"price":18}]}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/KeyUnauthorized","description":"No credentials were presented (`key_required`), or the API key is malformed, unknown or no longer active (`invalid_key`, `key_revoked`)."},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/products/{sku}":{"get":{"operationId":"getV1ProductsBySku","summary":"Get public product detail","description":"Returns one localized public product detail payload, including `updatedAt` — the last observed change to this product's catalog content, null when no change has been observed — and `inventoryUpdatedAt`, the last observed change to its inventory quantities, null for Jameo and made-to-order products. Examples document a standard Ethica product (100386U), a Jameo color-block product (01U-TS), and a made-to-order Ethica product (100155U).","tags":["Products"],"security":[{},{"bearerKey":[]}],"parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string","example":"100386U"},"description":"Product SKU, such as 100386U, 01U-TS, or 100155U. Case-insensitive: 100386u, the spelling of the website's product URLs, finds 100386U."},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en-CA","en-US","fr-CA"],"example":"en-CA"},"description":"Response locale. Defaults to en-CA."}],"responses":{"200":{"description":"Public product detail.","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"}},"content":{"application/json":{"schema":{"type":"object","required":["sku","slug","updatedAt","inventoryUpdatedAt","locale","productName","descriptions","keywords","brand","insufficientInventoryMessage","catalog","links","tag","minimumOrder","customization","studio","pricing","images","assets","colors","inventory"],"properties":{"sku":{"type":"string","example":"100386U"},"slug":{"type":"string","example":"100386u"},"updatedAt":{"type":["string","null"],"format":"date-time","description":"Last observed change to catalog content at ingestion, excludes inventory; null = no change observed since 2026-08-25. Stock movements, price-list re-imports and any other re-ingest of identical content leave it unchanged. For the last stock change, read `inventoryUpdatedAt` from `GET /v1/products/{sku}`.","example":"2026-08-20T08:40:00.000Z"},"inventoryUpdatedAt":{"type":["string","null"],"format":"date-time","description":"Last observed change to this product's inventory quantities, recorded a few minutes after the stock update that caused it; a stock update that leaves every quantity as it was does not move it. Always null for products with `customization.colorBlocks: true` (Jameo and made-to-order), whose inventory is a 9999 availability placeholder. Also null for a product whose inventory is not tracked yet, such as a new or upcoming product.","example":"2026-10-08T15:12:47.000Z"},"locale":{"type":"string","example":"en-CA"},"productName":{"type":"string","example":"Crewneck t-shirt"},"descriptions":{"type":"object","description":"Localized public product copy.","required":["tagline","short","long"],"properties":{"tagline":{"type":"string"},"short":{"type":"string"},"long":{"type":"string"}}},"keywords":{"type":"array","items":{"type":"string"}},"note":{"type":"string","description":"Optional customer-facing product note."},"brand":{"type":"object","required":["name","url","description"],"properties":{"name":{"type":"string","example":"Ethica"},"url":{"type":"string","description":"Public brand URL. Empty when no brand page is published.","example":"https://www.attraction.com/en-ca/products/ethica/"},"description":{"type":"string"}}},"insufficientInventoryMessage":{"type":"string","description":"The brand's message for an order that stock cannot cover. Empty when the brand has none."},"catalog":{"type":"object","required":["inspiration","category","for","fabrics"],"properties":{"inspiration":{"type":"array","items":{"type":"string"},"example":["Promotional"]},"category":{"type":["string","null"],"description":"The product's category. null when the product has no catalog classification.","example":"T-shirts"},"for":{"type":["string","null"],"description":"Who the product is cut for, such as Unisex or Woman. Empty for products without an audience, such as bags; null when the product has no catalog classification.","example":"Unisex"},"fabrics":{"type":"array","items":{"type":"string"},"description":"The product's fabrics. Empty when none is recorded.","example":["Jersey"]}}},"links":{"type":"object","required":["product"],"properties":{"product":{"type":"string","format":"uri","description":"The product's page on the public website.","example":"https://www.attraction.com/en-ca/products/100386u/"},"studio":{"type":"string","format":"uri","description":"Present only when the product is available in Studio.","example":"https://studio.jameo.com/home?lang=en"}}},"tag":{"type":"string","description":"Merchandising tag, such as Best seller. Empty when the product has none.","example":"Best seller"},"minimumOrder":{"type":"object","required":["quantity","description"],"properties":{"quantity":{"type":"number","example":36},"description":{"type":"string","example":"Minimum 36 decorated units. No minimum undecorated."},"madeToOrder":{"type":"object","description":"The run minimum of a product sewn for the order: a made-to-order product, or a product with colours of `type` `madeToOrder`, ordered in such a colour. Present only on those products.","required":["quantity","extendedQuantity","extendedAboveSizeCount","description"],"properties":{"quantity":{"type":"number","description":"The minimum for a run ordered in `extendedAboveSizeCount` sizes or fewer.","example":100},"extendedQuantity":{"type":"number","description":"The minimum for a run ordered in more than `extendedAboveSizeCount` sizes.","example":300},"extendedAboveSizeCount":{"type":"number","description":"The number of sizes above which `extendedQuantity` applies.","example":5},"description":{"type":"string","example":"Minimum of 100 units (for 5 sizes or fewer) or 300 units (for more than 5 sizes)."}}}}},"customization":{"type":"object","required":["colorBlocks","decorations"],"properties":{"colorBlocks":{"type":"boolean","description":"True for products displayed with the custom color-block wheel.","example":false},"colorBlocksTagline":{"type":"string","description":"Optional public tagline for color-block products.","example":"Over 300 combinations"},"decorations":{"type":"array","description":"Decoration techniques offered on the product, sorted by name.","items":{"type":"object","required":["name","note","icon","link"],"properties":{"name":{"type":"string","example":"Screen Printing"},"note":{"type":"string","description":"Short note about the technique. Empty when there is none.","example":""},"icon":{"type":"string","description":"URL of the technique's icon image.","example":"https://www.attraction.com/assets/icons/screen-printing.svg"},"link":{"type":"string","description":"Where to learn about or use the technique: a section of the decoration page, a resource PDF, or Studio for techniques designed there (Jameo). Empty when there is none.","example":"https://www.attraction.com/en-ca/decoration/#screen-printing"}}}}}},"studio":{"type":"object","required":["available"],"properties":{"available":{"type":"boolean","description":"Whether the public website can link to Studio for this product.","example":true}}},"pricing":{"type":"object","required":["currency","msrp"],"properties":{"currency":{"type":"string","example":"CAD"},"priceTier":{"type":"string","description":"The price tier of the `net` brackets: the current tier of the account the credentials belong to. Present on authenticated reads only.","example":"A3"},"msrp":{"type":"array","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"net":{"type":"array","description":"The account's net brackets at `priceTier`. Present on authenticated reads only.","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"sizes":{"type":"array","description":"Every size the product is sold in, in size order, with its upcharge when it has one: the MSRP upcharge, plus the tier's net upcharge on an authenticated read. Omitted for products without sizes.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"XL"},"surcharge":{"type":"object","description":"Omitted when the size has no upcharge.","required":["msrp"],"properties":{"msrp":{"type":"number","example":2},"net":{"type":"number","example":1.5}}}}}},"designCredits":{"type":"object","description":"Free design credits included with the product. Present only on products that include them.","required":["included"],"properties":{"included":{"type":"number","example":8},"description":{"type":"string"},"descriptionShort":{"type":"string","description":"Compact form of `description`.","example":"8 free design credits included"}}},"madeToOrderSurchargePercent":{"type":"number","description":"The percent a colour of `type` `madeToOrder` adds to every bracket of `msrp` and `net`, rounded to the cent. Size surcharges stay as listed. Present only when the product has such colours.","example":10}}},"images":{"type":"array","items":{"type":"object","required":["url","alt"],"properties":{"url":{"type":"string","format":"uri","example":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp"},"alt":{"type":"string","example":"Crewneck t-shirt"}}}},"assets":{"type":"object","required":["images","resources"],"properties":{"images":{"type":"array","items":{"type":"object","required":["url","alt"],"properties":{"url":{"type":"string","format":"uri","example":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp"},"alt":{"type":"string","example":"Crewneck t-shirt"}}}},"resources":{"type":"array","items":{"type":"object","required":["type","label","url"],"properties":{"type":{"type":"string","enum":["sizeChart"],"description":"The resource kind. Only the size chart is published; the high-resolution image archive is no longer offered as a resource.","example":"sizeChart"},"label":{"type":"string","example":"Size chart"},"url":{"type":"string","format":"uri"}}}}}},"sizeRecommendations":{"type":"array","description":"Recommended share of an order per size, from sales history. Covers the sizes the product sells today, named and ordered like `pricing.sizes`; the percentages sum to 100. Omitted when the product has no recommendation, including every single-size product.","items":{"type":"object","required":["size","percentage"],"properties":{"size":{"type":"string","example":"XL"},"percentage":{"type":"number","example":21.71}}}},"colors":{"type":"array","items":{"type":"object","required":["id","name","swatches","colorFamilies","images","type"],"properties":{"id":{"type":"string","example":"0001"},"pms":{"type":"string","example":"White"},"name":{"type":"string","example":"White"},"swatches":{"type":"array","items":{"type":"string"},"example":["#FFFFFF"]},"colorFamilies":{"type":"array","description":"Colour families the swatches were classified into: usually one, several for multi-tone colours, empty when the colour has no swatch to classify (made-to-order placeholders) or none close enough to a family.","items":{"type":"object","required":["name","hex"],"properties":{"name":{"type":"string","description":"Family name in the response locale, such as Green or Vert.","example":"Green"},"hex":{"type":"string","description":"The family's display colour as #RRGGBB. This is the palette entry shared by every colour in the family, not this colour's own swatch.","example":"#2F8F46"},"sortIndex":{"type":"integer","minimum":0,"description":"Position in the complete colour-family palette, ordered with Studio's perceptual display algorithm. Lower values come first; the rank is independent of locale and product filtering. May be absent for historical families outside the current palette; show those after ranked families."}}},"example":[{"name":"White","hex":"#F8F8F2"}]},"images":{"type":"array","items":{"type":"string","format":"uri"}},"type":{"type":"string","enum":["stock","madeToOrder","hyperCustom"],"description":"How the colour is supplied. `stock`: a colour in stock, with its rows in `inventory`. `madeToOrder`: sewn for the order. On a made-to-order product (`customization.colorBlocks`) it is one of the product's own colours, at the product's `minimumOrder` and `pricing`; on a product in stock it is a colour of the fabric chart beyond the stock ones, without inventory, at the minimum of `minimumOrder.madeToOrder` and with `pricing.madeToOrderSurchargePercent` added to the price. `hyperCustom`: a colour of a Jameo hyper custom product, at the product's `minimumOrder` and `pricing`. The `inventory` rows of made-to-order and hyper custom products are a placeholder, not stock. A product's own colours come first.","example":"stock"},"material":{"type":"object","description":"The colour's fabric. Each field is omitted when it is not recorded, and the object is omitted when none is.","properties":{"name":{"type":"string","description":"Customer-facing fabric name. Jameo products only.","example":"Jersey"},"composition":{"type":"string","example":"100% Organic cotton"},"weight":{"type":"string","description":"Fabric weight label, formatted for the response locale.","example":"7.4 oz/linear yd (150 gsm)"},"gsm":{"type":"number","description":"Fabric weight in g/m².","example":150}}}}}},"inventory":{"type":"array","items":{"type":"object","required":["colorId","size","quantity"],"properties":{"colorId":{"type":"string","example":"0001"},"size":{"type":"string","example":"M"},"quantity":{"type":"number","example":1916}}}}}},"examples":{"standardEthica":{"summary":"Standard product: 100386U","value":{"sku":"100386U","slug":"100386u","updatedAt":"2026-08-20T08:40:00.000Z","inventoryUpdatedAt":"2026-10-08T15:12:47.000Z","locale":"en-CA","productName":"Crewneck t-shirt","descriptions":{"tagline":"Crewneck t-shirt, our best-selling t-shirt. Ethica made in Canada.","short":"Crewneck t-shirt in jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour, our best-selling t-shirt, wide colour range. Made in Canada.","long":"Crewneck t-shirt. Fabric: jersey in organic cotton and recycled polyester, or 100% organic cotton depending on the colour. Key features: our best-selling t-shirt, wide colour range. Made in Canada by unionized workers. The company has been carbon neutral since 2022. Compatible decoration techniques: multi-colour screen printing, classic and 3D embroidery, water-based direct-to-garment printing, twill, etched suede, jersey or woven appliqués, and custom labels built to your specs. A fit for corporate orders, company events, tourist boutiques, community organizations and promotional campaigns running at scale."},"keywords":["t shirt","crewneck","ethica","made in canada","organic cotton"],"note":"For women, order a smaller size than usual (M=S), since this is a unisex style.","brand":{"name":"Ethica","url":"https://www.attraction.com/en-ca/products/ethica/","description":"Timeless classics, made in Canada with sustainable fibres."},"insufficientInventoryMessage":"Insufficient inventory for your project? Ethica styles can usually be produced quickly. Contact us and we'll confirm lead times.","catalog":{"inspiration":["Promotional"],"category":"T-shirts","for":"Unisex","fabrics":["Jersey"]},"links":{"product":"https://www.attraction.com/en-ca/products/100386u/","studio":"https://studio.jameo.com/home?lang=en"},"tag":"Best seller","minimumOrder":{"quantity":36,"description":"Minimum 36 decorated units. No minimum undecorated.","madeToOrder":{"quantity":100,"extendedQuantity":300,"extendedAboveSizeCount":5,"description":"Minimum of 100 units (for 5 sizes or fewer) or 300 units (for more than 5 sizes)."}},"customization":{"colorBlocks":false,"decorations":[{"name":"Screen Printing","note":"","icon":"https://www.attraction.com/assets/icons/screen-printing.svg","link":"https://www.attraction.com/en-ca/decoration/#screen-printing"}]},"studio":{"available":true},"pricing":{"currency":"CAD","msrp":[{"minQuantity":1,"maxQuantity":23,"price":30.5},{"minQuantity":24,"maxQuantity":99,"price":28},{"minQuantity":100,"maxQuantity":299,"price":26},{"minQuantity":300,"maxQuantity":499,"price":23.5}],"sizes":[{"name":"XS"},{"name":"S"},{"name":"M"},{"name":"L"},{"name":"XL"},{"name":"2XL","surcharge":{"msrp":4}},{"name":"3XL","surcharge":{"msrp":6}},{"name":"4XL","surcharge":{"msrp":8}},{"name":"5XL","surcharge":{"msrp":10}}],"madeToOrderSurchargePercent":10},"images":[{"url":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp","alt":"Crewneck t-shirt"}],"assets":{"images":[{"url":"https://www.attraction.com/assets/products/100386u/100386u-primary.webp","alt":"Crewneck t-shirt"}],"resources":[{"type":"sizeChart","label":"Size chart","url":"https://www.attraction.com/assets/products/100386u/100386u.pdf"}]},"sizeRecommendations":[{"size":"XS","percentage":1.96},{"size":"S","percentage":11.17},{"size":"M","percentage":22.38},{"size":"L","percentage":28.29},{"size":"XL","percentage":21.71},{"size":"2XL","percentage":9.94},{"size":"3XL","percentage":3.33},{"size":"4XL","percentage":0.93},{"size":"5XL","percentage":0.3}],"colors":[{"id":"0001","pms":"White","name":"White","type":"stock","material":{"composition":"100% Organic cotton","weight":"7.4 oz/linear yd (150 gsm)","gsm":150},"swatches":["#FFFFFF"],"colorFamilies":[{"name":"White","hex":"#F8F8F2","sortIndex":4}],"images":["https://www.attraction.com/assets/products/100386u/100386u-white.webp"]},{"id":"0057","name":"Mustard","type":"madeToOrder","swatches":["#E0B323"],"colorFamilies":[{"name":"Yellow","hex":"#E0B323","sortIndex":7}],"images":["https://www.attraction.com/assets/products/100386u/100386u-mustard.webp"]}],"inventory":[{"colorId":"0001","size":"M","quantity":1916}]}},"jameoColorBlocks":{"summary":"Jameo color-block product: 01U-TS","value":{"sku":"01U-TS","slug":"01u-ts","updatedAt":"2026-08-25T14:30:00.000Z","inventoryUpdatedAt":null,"locale":"en-CA","productName":"T-Shirt","descriptions":{"tagline":"A comfortable unisex round-neck tee.","short":"A flattering unisex fit with a classic round neck, designed for everyday comfort and effortless style.","long":"A flattering unisex fit with a classic round neck, designed for everyday comfort and effortless style. Made with a 50% cotton and 50% polyester blend for just the right amount of stretch, in a soft 200 GSM weight. This hyper custom product offers next-level customization, with countless combinations of colours, styles and decorations, for a result that stands out."},"keywords":["t shirt","unisex t shirt","hyper custom","jameo","colour blocks"],"brand":{"name":"Jameo","url":"https://www.attraction.com/en-ca/products/jameo/","description":"Hyper custom apparel made to stand out."},"insufficientInventoryMessage":"Jameo styles are made to order. For larger projects, contact us early to secure the fabrics needed to produce your order.","catalog":{"inspiration":["Promotional"],"category":"T-shirts","for":"Unisex","fabrics":["Jersey"]},"links":{"product":"https://www.attraction.com/en-ca/products/01u-ts/","studio":"https://studio.jameo.com/home?lang=en"},"tag":"","minimumOrder":{"quantity":20,"description":"Minimum of 20 units per design."},"customization":{"colorBlocks":true,"colorBlocksTagline":"Color blocks & trims","decorations":[{"name":"Centerfold woven label","note":"","icon":"https://live-specs.studio.jameo.com/decorations/clippingTags/clippingTag.jpg","link":"https://studio.jameo.com?lang=en"}]},"studio":{"available":true},"pricing":{"currency":"CAD","msrp":[{"minQuantity":20,"maxQuantity":29,"price":35},{"minQuantity":30,"maxQuantity":49,"price":33},{"minQuantity":50,"maxQuantity":149,"price":29},{"minQuantity":150,"maxQuantity":499,"price":26}],"sizes":[{"name":"XS"},{"name":"S"},{"name":"M"},{"name":"L"},{"name":"XL"},{"name":"2XL","surcharge":{"msrp":5}},{"name":"3XL","surcharge":{"msrp":5}},{"name":"4XL","surcharge":{"msrp":5}},{"name":"5XL","surcharge":{"msrp":5}}],"designCredits":{"included":8,"description":"This product comes with 8 free design credits, providing a solid base for colour changes and decorations so you don't have to pay for every little change.","descriptionShort":"8 free design credits included"}},"images":[{"url":"https://www.attraction.com/assets/products/01u-ts/01u-ts-primary.webp","alt":"T-Shirt"}],"assets":{"images":[{"url":"https://www.attraction.com/assets/products/01u-ts/01u-ts-primary.webp","alt":"T-Shirt"}],"resources":[{"type":"sizeChart","label":"Size chart","url":"https://www.jameo.com/sizes/unisex-hyper"}]},"colors":[{"id":"005","name":"Black","type":"hyperCustom","material":{"name":"Jersey","composition":"50% cotton, 50% polyester","weight":"9.8 oz/linear yd (200 gsm)","gsm":200},"swatches":["#000000"],"colorFamilies":[{"name":"Black","hex":"#000000","sortIndex":0}],"images":[]}],"inventory":[{"colorId":"005","size":"M","quantity":9999}]}},"madeToOrder":{"summary":"Made-to-order product: 100155U","value":{"sku":"100155U","slug":"100155u","updatedAt":"2026-10-06T13:54:04.726Z","inventoryUpdatedAt":null,"locale":"en-CA","productName":"Raglan long sleeve t-shirt","descriptions":{"tagline":"Made-to-order raglan long sleeve t-shirt, over 300 possible combinations. Ethica made-to-order, made in Canada.","short":"Made-to-order raglan long sleeve t-shirt in organic cotton and recycled polyester, over 300 possible combinations, minimum order of 100 units. Made to order in Canada.","long":"Made-to-order raglan long sleeve t-shirt. Fabric: organic cotton and recycled polyester. Key features: over 300 possible combinations, minimum order of 100 units, 3 to 4 weeks production lead time, made-to-order, no inventory. Made to order in Canada by unionized workers. This product is made to order and is not available from stock. The company has been carbon neutral since 2022. Compatible decoration techniques: multi-colour screen printing, classic and 3D embroidery, water-based direct-to-garment printing, twill, etched suede, jersey or woven appliqués, and custom labels built to your specs. A fit for corporate orders, company events, tourist boutiques, community organizations and promotional campaigns running at scale."},"keywords":["long sleeve","raglan","ethica","made to order","made in canada"],"note":"For women, order a smaller size than usual (M=S), since this is a unisex style.","brand":{"name":"Ethica","url":"https://www.attraction.com/en-ca/products/ethica/","description":"Timeless classics, made in Canada with sustainable fibres."},"insufficientInventoryMessage":"Insufficient inventory for your project? Ethica styles can usually be produced quickly. Contact us and we'll confirm lead times.","catalog":{"inspiration":["Promotional"],"category":"Long sleeves","for":"Unisex","fabrics":["Jersey"]},"links":{"product":"https://www.attraction.com/en-ca/products/100155u/"},"tag":"","minimumOrder":{"quantity":100,"description":"Minimum of 100 units (for 5 sizes or fewer) or 300 units (for more than 5 sizes).","madeToOrder":{"quantity":100,"extendedQuantity":300,"extendedAboveSizeCount":5,"description":"Minimum of 100 units (for 5 sizes or fewer) or 300 units (for more than 5 sizes)."}},"customization":{"colorBlocks":true,"colorBlocksTagline":"Over 300 combinations","decorations":[{"name":"Digital Print (DTG)","note":"","icon":"https://www.attraction.com/assets/icons/digital-printing.svg","link":"https://www.attraction.com/en-ca/decoration/#digital-printing"}]},"studio":{"available":false},"pricing":{"currency":"CAD","msrp":[{"minQuantity":100,"maxQuantity":299,"price":43},{"minQuantity":300,"maxQuantity":499,"price":39}],"sizes":[{"name":"XS"},{"name":"S"},{"name":"M"},{"name":"L"},{"name":"XL"},{"name":"2XL","surcharge":{"msrp":4}},{"name":"3XL","surcharge":{"msrp":6}},{"name":"4XL","surcharge":{"msrp":8}},{"name":"5XL","surcharge":{"msrp":10}}]},"images":[{"url":"https://www.attraction.com/assets/products/100155u/100155u-primary.webp","alt":"Raglan long sleeve t-shirt"}],"assets":{"images":[{"url":"https://www.attraction.com/assets/products/100155u/100155u-primary.webp","alt":"Raglan long sleeve t-shirt"}],"resources":[{"type":"sizeChart","label":"Size chart","url":"https://www.attraction.com/assets/products/100155u/100155u.pdf"}]},"colors":[{"id":"0909","pms":"","name":"Made-To-Order","type":"madeToOrder","material":{"composition":"Main material: 50% Organic cotton / 50% Recycled polyester, Trims: 100% Organic cotton","weight":"7.4 oz/linear yd (150 gsm)","gsm":150},"swatches":[],"colorFamilies":[],"images":["https://www.attraction.com/assets/products/100155u/100155u-made-to-order.webp"]}],"inventory":[{"colorId":"0909","size":"M","quantity":9999}]}}}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/KeyUnauthorized","description":"An API key was presented but is malformed, unknown or no longer active (`invalid_key`, `key_revoked`). Without a key the route answers 200 with public pricing instead."},"404":{"$ref":"#/components/responses/NotFound","description":"No product matches the SKU in the requested locale (`product_not_found`)."},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/v1/products/{sku}/pricing":{"get":{"operationId":"getV1ProductsBySkuPricing","summary":"Get a product's price brackets for the authenticated account","description":"Returns one product's quantity price brackets on their own — the same numbers the product detail carries, without the rest of the payload. Unlike the other catalogue routes this one has no public representation: brackets are reported for one account's price tier, so the request must carry credentials. Send an API key as `Authorization: Bearer attr_sk_…`; a request without credentials answers 401 `key_required`. The `priceTier` in the response is the account's current tier, so it can change between calls if the account's tier changes.","tags":["Products"],"security":[{"bearerKey":[]}],"parameters":[{"name":"sku","in":"path","required":true,"schema":{"type":"string","example":"100386U"},"description":"Product SKU, such as 100386U, 01U-TS, or 100155U. Case-insensitive: 100386u, the spelling of the website's product URLs, finds 100386U."},{"name":"locale","in":"query","required":false,"schema":{"type":"string","enum":["en-CA","en-US","fr-CA"],"example":"en-CA"},"description":"Response locale. Defaults to en-CA."}],"responses":{"200":{"description":"Price brackets for the authenticated account's tier.","headers":{"RateLimit":{"$ref":"#/components/headers/RateLimit"},"RateLimit-Policy":{"$ref":"#/components/headers/RateLimit-Policy"}},"content":{"application/json":{"schema":{"type":"object","title":"ProductPricing","required":["sku","currency","msrp"],"properties":{"sku":{"type":"string","example":"100386U"},"currency":{"type":"string","example":"CAD"},"priceTier":{"type":"string","description":"The price tier these brackets were served at — the current tier of the account the API key belongs to. Present on authenticated reads only.","example":"A3"},"msrp":{"type":"array","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"net":{"type":"array","description":"The account's net brackets at `priceTier`.","items":{"type":"object","required":["minQuantity","maxQuantity","price"],"properties":{"minQuantity":{"type":"number","example":36},"maxQuantity":{"type":["number","null"],"example":99},"regularPrice":{"type":"number","description":"The price before a markdown, present **only when `price` is genuinely reduced**. At regular pricing the field is omitted rather than repeated as `price`, so its presence is what identifies a bracket as marked down — read `price` for what to charge, and `regularPrice` only to show the saving.","example":32},"price":{"type":"number","description":"Price for this quantity bracket: the public MSRP in `msrp`, the account's own net price in `net`. Net brackets appear only on authenticated requests — with an API key or a Studio session (see Authentication).","example":28}}}},"sizes":{"type":"array","description":"Every size the product is sold in, in size order, with its upcharge when it has one: the MSRP upcharge, plus the tier's net upcharge on an authenticated read. Omitted for products without sizes.","items":{"type":"object","required":["name"],"properties":{"name":{"type":"string","example":"XL"},"surcharge":{"type":"object","description":"Omitted when the size has no upcharge.","required":["msrp"],"properties":{"msrp":{"type":"number","example":2},"net":{"type":"number","example":1.5}}}}}}}},"example":{"sku":"100386U","currency":"CAD","priceTier":"A3","msrp":[{"minQuantity":36,"maxQuantity":99,"regularPrice":28,"price":24}],"net":[{"minQuantity":36,"maxQuantity":99,"regularPrice":18.5,"price":16}]}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/KeyUnauthorized","description":"No credentials were presented (`key_required`), or the API key is malformed, unknown or no longer active (`invalid_key`, `key_revoked`)."},"404":{"$ref":"#/components/responses/NotFound","description":"No product matches the SKU in the requested locale (`product_not_found`)."},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"$ref":"#/components/responses/TooManyRequests"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}}}}