GET /v1/filings/diff - SEC API for AI

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/filings/diff?ticker=AAPL&form=10-K"

{
  "object": "error",
  "id": "err_example",
  "code": "filings_intelligence_not_available",
  "type": "invalid_request_error",
  "message": "The filings-intelligence plane is not enabled.",
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "details": {}
}

Filing comparison endpoint (currently unavailable)

Audience: application and coding agent.

Coverage and source scope

This endpoint is currently unavailable and returns 404 filings_intelligence_not_available. When available, it will compare a selected issuer filing with a prior-period or explicitly chosen counterpart and return section-level change information. Any comparison is a review aid based on rendered filing text, not a determination of materiality or legal significance.

Current availability

This endpoint currently returns 404 filings_intelligence_not_available. It is documented here so clients can prepare for the contract, but it is not available for active filing comparison. When it becomes available, treat its rendered-text comparison as a review aid and open the cited filings before relying on a change.

Canonical metadata

requestId
traceparent
code
message
details

Example request

curl -X GET \
  -H "x-api-key: $SECAPI_API_KEY" \
  -H "secapi-version: 2026-03-19" \
  "https://api.secapi.ai/v1/filings/diff?ticker=AAPL&form=10-K"

404 response

{
  "object": "error",
  "id": "err_example",
  "code": "filings_intelligence_not_available",
  "type": "invalid_request_error",
  "message": "The filings-intelligence plane is not enabled.",
  "requestId": "req_2ZK8Q1W9F4M6P7R3",
  "details": {}
}

Give this prompt to your agent

Failure posture

treat 404 filings_intelligence_not_available as the current endpoint state, not an empty result
do not retry this endpoint as an active dependency until filings intelligence is enabled
preserve requestId and traceparent in logs and downstream reports

​Coverage and source scope

​Current availability

​Canonical metadata

​Example request

​404 response

​Give this prompt to your agent

​Failure posture

Coverage and source scope

Current availability

Canonical metadata

Example request

404 response

Give this prompt to your agent

Failure posture