# ScentPulse Batch Fragrance Code Check

> ScentPulse Batch Fragrance Code Check is a paid API for AI agents from scentpulse-xi.vercel.app, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Decodes one or more fragrance batch codes to identify brand, production date, and freshness verdict for perfumes

## Facts

- Endpoint: GET https://scentpulse-xi.vercel.app/api/scent/batch-check
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scentpulse-batch-fragrance-code-check-efa1dfe2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_wKqrDZMB0dF-EL0ZztUAz

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 scentpulse-batch-fragrance-code-check-efa1dfe2
```

Example prompt: Can you check batch code 2634 on my Gucci perfume and tell me how fresh it is and when it was likely produced?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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).

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "code": "2634",
  "brand": "Gucci",
  "confidence": "HIGH",
  "freshness_verdict": "fresh — recent production",
  "estimated_production": "2026, ISO week 34"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scentpulse-batch-fragrance-code-check-efa1dfe2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scentpulse-xi.vercel.app](https://www.zero.xyz/host/scentpulse-xi.vercel.app/llms.txt)