---
title: "Verify changes in newer SEC filings"
method: POST
path: "/v1/research/changes/{identifier}"
---

# Verify changes in newer SEC filings

`POST /v1/research/changes/{identifier}`

## Request

- Base URL: `https://filedproof.davisvillelabs.com`
- URL: `https://filedproof.davisvillelabs.com/v1/research/changes/{identifier}`
- Auth: none declared

Compare new same-form SEC filings since an optional checkpoint and return ranked changes that show which disclosures deserve attention first, with before/after evidence from SEC filings, deterministic analytical labels, exact provenance, and retry-safe checkpoint state. Callers may supply a freeform topic or profile=financial_risk for liquidity, debt, dilution/equity-issuance, and changed-risk coverage. For profile=financial_risk, documented changes are separated from deterministic category/attention interpretation; omission does not prove a risk disappeared, a shelf or authorization is not money raised, and potential dilution is not realized dilution. Use the $0.10 fast material filing-change operation first when a same-form filing pair is enough. A delivery retry repeats the identical authorized request with the same payment credential or proof. Changing any payment-bound argument starts a new invocation and requires a new authorization when commerce is active.

## Path parameters

- `identifier` string, required

## Headers

- `Payment-Authorization` string

## Request body

- union
  - object
    - `sinceAccession` string: Checkpoint accession from the prior monitor-check.v1 result.
    - `topic` string, required: Freeform disclosure topic. Provide topic or profile, not both.
    - `profile` 'financial_risk': Bounded profile covering liquidity, debt, dilution/equity issuance, and changed risk disclosures. Provide profile or topic, not both.
    - `forms` string[]
    - `history` boolean
    - `item` string
    - `maxNewFilings` integer
    - `comparisonLimit` integer
    - `limit` integer
    - `maxArchiveFiles` integer
  - object
    - `sinceAccession` string: Checkpoint accession from the prior monitor-check.v1 result.
    - `topic` string: Freeform disclosure topic. Provide topic or profile, not both.
    - `profile` 'financial_risk', required: Bounded profile covering liquidity, debt, dilution/equity issuance, and changed risk disclosures. Provide profile or topic, not both.
    - `forms` string[]
    - `history` boolean
    - `item` string
    - `maxNewFilings` integer
    - `comparisonLimit` integer
    - `limit` integer
    - `maxArchiveFiles` integer

## Response `200`

monitor-check.v1 paid specialist result. Inspect status, haltedOnFailure, truncated, remainingNewFilings, and checkpoint.

- object
  - `schemaVersion` 'monitor-check.v1', required
  - `purpose` string, required
  - `issuer` object, required
  - `topic` string, required
  - `reportProfile` 'financial_risk' | 'null', nullable
  - `forms` string[], required
  - `mode` 'initial_snapshot' | 'incremental', required
  - `status` 'no_new_filing' | 'checked' | 'change_detected' | 'partial_failure', required
  - `changeDetected` boolean, required
  - `checkpoint` object, nullable, required
    - `accession` string, required
    - `form` string, nullable, required
    - `filingDate` string, nullable, required
    - `reportDate` string, nullable, required
  - `priorCheckpoint` object, nullable, required
    - `accession` string, required
    - `form` string, nullable, required
    - `filingDate` string, nullable, required
    - `reportDate` string, nullable, required
  - `latestAvailable` object, nullable, required
    - `accession` string, required
    - `form` string, nullable, required
    - `filingDate` string, nullable, required
    - `reportDate` string, nullable, required
  - `newFilingsDetected` integer, required
  - `events` object[], required
    - `schemaVersion` 'monitor-event.v1', required
    - `status` 'topic_change_detected' | 'no_detected_topic_change' | 'insufficient_baseline' | 'comparison_failed', required
    - `current` object, nullable, required
      - `accession` string, required
      - `form` string, nullable, required
      - `filingDate` string, nullable, required
      - `reportDate` string, nullable, required
    - `baseline` object, nullable, required
      - `accession` string, required
      - `form` string, nullable, required
      - `filingDate` string, nullable, required
      - `reportDate` string, nullable, required
    - `change` object, nullable, required
      - `schemaVersion` 'disclosure-change.v1', required
      - `changed` boolean, required
      - `changes` object[], required
        - `kind` 'addition' | 'removal' | 'revised_disclosure' | 'moved_equivalent', required
        - `category` string, required
        - `attention` object, required
          - `level` 'high' | 'medium' | 'low', required
          - `score` number, required
        - `confidence` 'high' | 'medium' | 'low', required
        - `signals` union[], required
          - union
            - string
            - object
        - `classification` object
        - `reportingContext` object, nullable
        - `numericAnchors` object
        - `coverageCategories` string[]
        - `before` object, nullable, required
        - `after` object, nullable, required
      - `changeCount` integer
      - `highPriorityChangeCount` integer
      - `overallAttention` 'high' | 'medium' | 'low' | 'none'
      - `attentionCounts` object
        - `high` integer, required
        - `medium` integer, required
        - `low` integer, required
      - `limitations` string[]
      - `reportProfile` string
      - `coverage` object
    - `limitation` string
    - `searchScope` object
    - `error` object
      - `code` string, required
      - `message` string, required
      - `retryable` boolean, required
  - `truncated` boolean, required
  - `remainingNewFilings` integer, required
  - `haltedOnFailure` boolean, required
  - `changeCount` integer, required
  - `highPriorityChangeCount` integer, required
  - `overallAttention` 'high' | 'medium' | 'low' | 'none', required
  - `attentionCounts` object, required
    - `high` integer, required
    - `medium` integer, required
    - `low` integer, required
  - `scope` object, required
  - `limitations` string[]
  - `agentGuidance` object, required
    - `reviewOrder` string
    - `nextAction` string, required
    - `invocationBoundary` string, required

## Other responses

- `402`: Payment challenge after pre-payment applicability validation. MPP uses WWW-Authenticate; x402 v2 HTTP uses PAYMENT-REQUIRED.
- `409`: Checkpoint is invalid or already current; no payment challenge is issued.
- `422`: Requested monitoring scope has no comparable same-form baseline; no payment challenge is issued.
- `503`: Specialist operation or payment provider temporarily unavailable.

---

[API](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api.md) · [All operations](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api/llms.txt) · [OpenAPI document](https://skmtc.dev/davisvillelabs/apis/filedproof-agent-research-api/revisions/16aba105f233?raw)