# DecaData Company Sales & Units

> DecaData Company Sales & Units is a paid API for AI agents from api.decadata.io, paid per call via x402, $5/call, status unknown (last checked 2026-10-30).

Returns daily or weekly point-of-sale sales dollars and unit counts for a specific US consumer company, sourced from transactions at eight US retailers, identified by ISIN or ticker.

## Facts

- Endpoint: GET https://api.decadata.io/v1/companies/%7Bid%7D/sales?utm_source=zero.xyz
- Price: $5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/decadata-company-sales-units-a3ca598f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3AIZBe8je3P5nqq0Izei8

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 decadata-company-sales-units-a3ca598f
```

Example prompt: Pull me the daily point-of-sale sales and units for PepsiCo (ticker PEP) from September 1 to September 30, 2026 using DecaData — I want actual retail transaction data, not SEC filings.

## When to prefer this

Choose this endpoint when you need actual point-of-sale retail transaction data (sales dollars and unit volumes) for a specific US consumer company, as opposed to government aggregates, SEC filings, or analyst estimates. Prefer this when you need company-level granularity by ISIN or ticker, historical data back to 2018, daily or weekly cadence, and brand-to-owner mapping that reflects ownership at the time of sale without restated history.

## Known failure modes

- Company not in coverage (~380 companies supported) — returns error or empty result
- Date range outside available history (data starts 2018-01-01) — returns no rows
- Requesting daily frequency for a tier-3 company only available weekly — may return error or fall back
- Invalid ISIN or ticker format — schema validation error
- Insufficient payment or payment failure — 402 response blocking data delivery
- Future date requested beyond T+7 availability — no data returned

## How this service works

Point-of-sale sales and units for ~380 US consumer companies, by ISIN or ticker, from transactions at eight US retailers: not government aggregates or SEC filings. Daily for the largest, weekly for all, from 2018, at T+7; each brand mapped to its owner at the time, history never restated. From $1 a request, priced per company-day. Free: sample (/v1/companies/{id}/sample), quote (/v1/quote), coverage (/v1/coverage). Docs: https://api.decadata.io/llms.txt

## Output

Returns a JSON object with the queried date range, frequency, and an array of rows each containing date, sales (USD), units sold, number of panel stores, and optionally unique stores and customers. Also includes company metadata (ISIN, ticker, name, tier, first/last available date), currency, price paid, licence notice, and a receipt ID.

## 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"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "The company: an ISIN (US7134481081), isin:US7134481081, or ticker:PEP"
      }
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "to": {
       "type": "string",
       "description": "Last day, YYYY-MM-DD (default: the latest on sale, T+7)"
      },
      "freq": {
       "enum": [
        "daily",
        "weekly"
       ],
       "type": "string",
       "description": "daily (tiers 1-2) or weekly"
      },
      "from": {
       "type": "string",
       "description": "First day, YYYY-MM-DD (default: to, or the week of to if weekly)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "to": "2026-09-01",
  "freq": "daily",
  "from": "2026-09-01",
  "rows": [
   {
    "date": "2026-09-01",
    "sales": 740000.49,
    "units": 160000,
    "panel_stores": 2100,
    "unique_stores": null,
    "unique_customers": null
   }
  ],
  "company": {
   "isin": "US7134481081",
   "name": "PEPSICO INC",
   "tier": 1,
   "ticker": "PEP",
   "last_date": "2026-10-07",
   "first_date": "2018-01-01"
  },
  "licence": "Licensed to the purchaser for its own research. No redistribution or resale.",
  "receipt": "rcpt_5f0c2a9d81e4b7c36a10",
  "currency": "USD",
  "price_usd": 5,
  "available_through": "2026-10-07"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/decadata-company-sales-units-a3ca598f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.decadata.io](https://www.zero.xyz/host/api.decadata.io/llms.txt)