> ## Documentation Index
> Fetch the complete documentation index at: https://docs.secapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /v1/owners/13f/compare

> Compare the latest two parsable 13F ownership reports for a manager CIK

Compare the latest two parsable 13F ownership reports for a manager CIK

<Info>
  Audience: application and coding agent.
</Info>

## Canonical metadata

* `requestId`
* `traceparent`
* `provenance`
* `freshness`
* `materialization`

## Example request

<RequestExample>
  ```bash theme={null}
  curl -X POST \
    -H "x-api-key: $SECAPI_API_KEY" \
    -H "secapi-version: 2026-03-19" \
    -H "content-type: application/json" \
    -d '{"cik":"0001350694","limit":50}' \
    "https://api.secapi.ai/v1/owners/13f/compare"
  ```
</RequestExample>

## Example response

<ResponseExample>
  ```json theme={null}
  {
    "object": "ownership_comparison",
    "id": "owncmp_0001350694_20250214_20241114",
    "createdAt": "2026-07-10T18:00:00.000Z",
    "livemode": false,
    "entityId": "ent_example_manager",
    "ticker": null,
    "managerName": "Example Manager",
    "currentFilingDate": "2025-02-14",
    "previousFilingDate": "2024-11-14",
    "rows": [{
      "issuer": "Example Issuer",
      "cusip": "000000000",
      "status": "changed",
      "currentValueUsdThousands": 1200,
      "previousValueUsdThousands": 900,
      "deltaValueUsdThousands": 300,
      "currentShares": 10000,
      "previousShares": 8000,
      "deltaShares": 2000
    }],
    "summaryMd": "Compared the latest two parsable 13F reports.",
    "provenance": { "source": "sec", "accessionNumber": "0000000000-00-000000", "filingUrl": "https://www.sec.gov/Archives/edgar/data/example", "retrievedAt": "2026-07-10T18:00:00.000Z", "parserVersion": "example", "rawSourceKey": "0000000000-00-000000" }
  }
  ```
</ResponseExample>

## Give this prompt to your agent

<Prompt>
  Use SEC API POST /v1/owners/13f/compare to compare the latest two parsable 13F ownership reports for a manager CIK. Preserve `requestId`, `traceparent`, `provenance`, `freshness`, `materialization` in the output. Return a concise markdown summary plus the exact structured payload fields that a downstream engineer or agent should keep using this result.
</Prompt>

## Failure posture

* treat non-2xx responses as contract-aware failures, not free-form errors
* preserve `requestId` and `traceparent` in logs and downstream reports
* if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff