{"uid":"cap_wKqrDZMB0dF-EL0ZztUAz","slug":"scentpulse-batch-fragrance-code-check-efa1dfe2","name":"ScentPulse Batch Fragrance Code Check","description":"Perfume batch/lot code decoder — estimates production date and freshness verdict from a bottle batch code, using an in-house deterministic decoder covering Coty, Estee Lauder-group, Chanel, LVMH/Dior-group, and L'Oreal Luxe house formats, with an explicit confidence tier (never false precision).","url":"https://scentpulse-xi.vercel.app/api/scent/batch-check","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"code":{"type":"string","description":"R25 | 8301 | 2634 (required — the batch/lot code, usually on the bottle base or box bottom)"},"lang":{"type":"string","description":"en | de | fr | es | ar | ja | ko | zh | pt"},"brand":{"type":"string","description":"Chanel | Tom Ford | Gucci | Dior | YSL (required — brand printed on the bottle)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"errors":{"type":"object","description":"Documented error responses, keyed by HTTP status code","additionalProperties":{"type":"object","required":["description"],"properties":{"example":{"type":"object"},"description":{"type":"string"}}}},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"code":"2634","brand":"Gucci","confidence":"HIGH","freshness_verdict":"fresh — recent production","estimated_production":"2026, ISO week 34"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_JZbtBbNLCMwrIXxN5Ofgi","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Decodes one or more fragrance batch codes to identify brand, production date, and freshness verdict for perfumes","exampleAgentPrompt":"Can you check batch code 2634 on my Gucci perfume and tell me how fresh it is and when it was likely produced?","exampleUseCases":[{"title":"Blind buy freshness verification","prompt":"I just received a blind buy of a Chanel fragrance with batch code 4B21 — can you decode that and tell me if it's a fresh recent batch or if I'm getting old stock?"},{"title":"Multi-bottle collector audit","prompt":"I want to check batch codes on three bottles I picked up: Dior code 3H14, YSL code 2J09, and Gucci code 1K45 — can you run all of them and tell me the production dates and freshness verdicts?"},{"title":"Dupe hunter age check","prompt":"I found a perfume being sold as a dupe alternative and the batch code is 5F30 from what claims to be Tom Ford — can you tell me when it was made and how confident you are in the reading?"}],"resultDescription":"Returns a JSON object per batch code containing the decoded brand name, the raw batch code, a confidence level (e.g. HIGH/MEDIUM/LOW), a freshness verdict in plain English, and the estimated production date down to ISO year and week.","failureModes":["Unknown or unrecognized batch code format — returns low confidence or null production estimate","Brand not in database — confidence returned as LOW with partial decoding","Malformed input batch code string — may return decoding error","Rate limiting or payment failure via x402 header — returns 402 Payment Required","Ambiguous code matching multiple brands — returns multiple candidate results with confidence scores"],"whenToPreferThis":"Use this endpoint when you need to decode one or more perfume batch codes to determine manufacturing date and freshness, especially for blind buyers verifying stock age, collectors auditing their bottles, or dupe hunters checking authenticity signals. It handles batch lookups efficiently, making it superior to single-code lookup endpoints when checking multiple bottles at once.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:39:28.825Z","isFirstParty":false}