{"uid":"cap_WJDYfxIlckQhInoDOskMu","slug":"oneshot-agent-api-data-changes-history-234e19da","name":"OneShot Agent API – Data Changes History","description":"Dated changes recorded for one entity since a date, with the earlier value, the later value, when each was seen and the source","url":"https://win.oneshotagent.com/v1/tools/changes?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__zTLY8MTlsDLQgOE6gNna","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the history of changes for a stored data attribute (e.g. vehicle identification, company info) over a specified date window","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Vehicle record change audit","prompt":"Pull the full change history for VIN 1HGCM82633A004352 on the vehicle_identification attribute between January 1 and June 30 2026 — I want to see every field that was updated, oldest first, up to 200 records."},{"title":"Company data drift monitoring","prompt":"What has changed in the company enrichment data for domain acme.com since March 1 2026? Show me the before and after values for each field that was updated."},{"title":"Stored search result changelog","prompt":"I ran a person enrichment search earlier — can you show me the changes recorded for that stored search since April 15 2026, limited to the most recent 50 entries?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T06:35:12.706Z","isFirstParty":false,"canonicalSlug":"oneshot-agent-api-data-changes-history-234e19da"}