# Annalist API Changes Feed

> Annalist API Changes Feed is a paid API for AI agents from api.annalist.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-21).

Returns dated, signed contract changes (additions, removals, breaking changes) across widely-used public APIs parsed from their OpenAPI specs daily

## Facts

- Endpoint: GET https://api.annalist.dev/v1/apis/changes?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-21
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/annalist-api-changes-feed-a1c9e328
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IdjQpWNWDqsVhcvC0scA0

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 annalist-api-changes-feed-a1c9e328
```

Example prompt: Show me all breaking API changes for Stripe over the last 14 days — I want to know what operations or fields were removed or newly required.

## When to prefer this

Choose this endpoint when you need machine-readable, dated, classified API contract change history for major public APIs (Stripe, GitHub, OpenAI, Twilio, Slack, Plaid, Datadog, etc.) without scraping changelogs manually. Ideal for CI/CD pipelines, integration monitoring agents, or developer tools that need to detect breaking changes before they cause failures. Prefer over manual changelog parsing because changes are normalized, classified as breaking or not, and cryptographically signed.

## Known failure modes

- Invalid 'days' value outside 1-90 range returns an error
- Unknown API name passed to 'api=' returns empty results or error
- Payment failure via x402 blocks the response
- No changes in the requested window returns an empty change list
- Signature verification failure if response is tampered in transit

## How this service works

Dated contract changes in widely used public APIs (Stripe, GitHub, OpenAI, Twilio, Slack, Plaid, Datadog and more), from their published OpenAPI descriptions read daily: operations, parameters and request fields added, removed or newly required, each change marked breaking or not. Last 1 to 90 days, one API with api=, or only breaking changes with breaking=true. Signed.

## Output

A signed JSON response listing dated API contract changes per API, each entry indicating the change type (operation added/removed, parameter added/removed/newly required), the specific field or endpoint affected, whether the change is breaking, and the date it was detected — filtered by API name and/or day range as requested.

## 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"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "api": {
       "type": "string",
       "description": "optional: one API, for example stripe or github"
      },
      "days": {
       "type": "string",
       "description": "how many days back, 1 to 90 (default 30)"
      },
      "breaking": {
       "type": "string",
       "description": "optional: true for breaking changes only"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/annalist-api-changes-feed-a1c9e328/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.annalist.dev](https://www.zero.xyz/host/api.annalist.dev/llms.txt)