# TiresAPI Inventory By-Day (Historical Snapshot)

> TiresAPI Inventory By-Day (Historical Snapshot) is a paid API for AI agents from tiresapi.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Returns paginated inventory rows for a specific UTC date snapshot, filterable by tire size, SKU, retailer, or state.

## Facts

- Endpoint: GET https://tiresapi.com/api/v1/corpus/inventory/by-day
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiresapi-com-7ed8a54b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5cG30y8vDf8ZjrFHjWol3

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 tiresapi-com-7ed8a54b
```

Example prompt: Pull all tire inventory rows for size 225/65R17 in Texas from the 2024-03-15 snapshot — page through up to 500 results at a time.

## When to prefer this

Use this endpoint when you need historical tire inventory data for a specific past date — ideal for time-series analysis, price trend research, or auditing what was in stock on a given day. Prefer this over the latest-snapshot endpoint when you need point-in-time historical records rather than current availability. Use the summary=true mode (via the history walk endpoint) for aggregate band analysis; use this by-day endpoint when you need raw per-store rows for a single date partition.

## Known failure modes

- Missing required utc_date parameter returns 400 Bad Request
- Invalid date format (not YYYY-MM-DD) returns 400 with pattern validation error
- State code not matching ^[A-Z]{2}$ pattern returns 400
- No inventory found for the given partition returns empty data array (auto-credited)
- limit exceeds 500 returns 400 validation error
- Invalid cursor token returns 400 or 422
- Payment not included or insufficient returns 402 Payment Required

## How this service works

Inventory rows for a single last_extracted partition (single SKU or size).

## Output

A paginated array of inventory records for the requested date snapshot, each containing store location (city, state, zip, store number), tire details (size, brand, model, brand_tier), pricing (single_price), retailer identifier, and the key_brand_mpc hash. Includes pagination cursor and metadata such as as_of timestamp.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 100,
   "state": "TX",
   "utc_date": "2024-03-15",
   "tire_size": "225/65R17"
  }
 }
}
```

## 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",
     "required": [
      "utc_date"
     ],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 500,
       "maximum": 500,
       "minimum": 1
      },
      "state": {
       "type": "string",
       "pattern": "^[A-Z]{2}$"
      },
      "cursor": {
       "type": "string"
      },
      "utc_date": {
       "type": "string",
       "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
       "description": "UTC snapshot date."
      },
      "tire_size": {
       "type": "string"
      },
      "retailer_key": {
       "type": "string"
      },
      "key_brand_mpc": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "utc_date",
      "page"
     ],
     "properties": {
      "data": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "city": {
          "type": [
           "string",
           "null"
          ]
         },
         "size": {
          "type": "string"
         },
         "brand": {
          "type": [
           "string",
           "null"
          ]
         },
         "model": {
          "type": [
           "string",
           "null"
          ]
         },
         "state": {
          "type": [
           "string",
           "null"
          ]
         },
         "zip_code": {
          "type": [
           "string",
           "null"
          ]
         },
         "store_num": {
          "type": [
           "string",
           "null"
          ]
         },
         "tire_size": {
          "type": "string"
         },
         "brand_tier": {
          "enum": [
           "Best",
           "Better",
           "Good",
           "Economy",
           null
          ],
          "type": [
           "string",
           "null"
          ],
          "description": "f
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": [
   {
    "size": "235/55R17",
    "store_num": "1234",
    "history_id": 987654321,
    "retailer_key": "DISCOUNTTIRE",
    "single_price": 142.99,
    "key_brand_mpc": "AAECAw",
    "last_extracted": "2026-05-19T18:00:00Z"
   }
  ],
  "page": {
   "cursor": "142.99|DISCOUNTTIRE|1234|987654321",
   "has_more": true
  },
  "utc_date": "2026-05-19"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiresapi-com-7ed8a54b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tiresapi.com](https://www.zero.xyz/host/tiresapi.com/llms.txt)