# OneShot Agent API – Data Changes History

> OneShot Agent API – Data Changes History is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Returns the history of changes for a stored data attribute (e.g. vehicle identification, company info) over a specified date window

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/changes?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-data-changes-history-234e19da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_WJDYfxIlckQhInoDOskMu

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 oneshot-agent-api-data-changes-history-234e19da -d '<json body>'
```

Example prompt: Show me all the changes recorded for VIN 1HGCM82633A004352 using the vehicle_identification attribute from March 1 to June 10 2026, up to 100 results oldest first.

## When to prefer this

Use this endpoint when you need to track how a specific data attribute (vehicle, company, person) has changed over time for a known entity key or stored search. It is ideal for auditing data drift, verifying data freshness, or building change-alert workflows. Prefer this over a fresh enrichment call when you already have a stored key and want historical deltas rather than the current snapshot.

## Known failure modes

- Missing both key and input — exactly one must be provided, returns validation error
- Invalid date format for since/until — must be YYYY-MM-DD
- Limit out of range — must be between 1 and 200
- Unknown attribute name — attribute does not support change history
- No changes found in the requested window — empty changes array returned
- Payment failure via x402 — USDC payment on Base not confirmed

## How this service works

Dated changes recorded for one entity since a date, with the earlier value, the later value, when each was seen and the source

## Output

Returns a JSON object containing the entity key, the attribute name, a list of change records (each with field name, before value, after value, change date, and data source), and metadata flags indicating whether the result is partial or truncated and the earliest recorded date.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "key": {
   "type": "string",
   "description": "Entity key the data tool declares. Give exactly one of key and input"
  },
  "input": {
   "type": "object",
   "description": "Stored search input; healthcare_exclusions accepts {entity: person|company, release: YYYY-MM, name? | npi? | upin?, previous_release?, after?}. Exact row membership, not person identity. Give exactly one of key and input"
  },
  "limit": {
   "type": "number",
   "description": "Most changes to return, oldest first (1-200, default 50)"
  },
  "since": {
   "type": "string",
   "description": "First day of the window, YYYY-MM-DD; optional for healthcare_exclusions monthly releases"
  },
  "until": {
   "type": "string",
   "description": "Last day of the window, YYYY-MM-DD (default: today)"
  },
  "source": {
   "type": "string",
   "description": "Source to read when the attribute has several"
  },
  "attribute": {
   "type": "string",
   "description": "Name of a data tool that keeps history, e.g. vehicle_identification, or of a published dataset attribute, e.g. company_operating_authority"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "key": "1HGCM82633A004352",
  "changes": [
   {
    "after": "HONDA MOTOR",
    "as_of": null,
    "field": "make",
    "before": "HONDA",
    "source": "US National Highway Traffic Safety Administration",
    "changed_on": "2026-06-10"
   }
  ],
  "partial": false,
  "attribute": "vehicle_identification",
  "truncated": false,
  "history_gaps": [],
  "recorded_since": "2026-03-02"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-data-changes-history-234e19da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)