/events/filing

Read one event filing, with optional Item selection, original text and attachments.

POST/api/v1/events/filing

Rate limit60 per minute

Request:

filing_idinteger

An id from /events/filings or /screener/events. 1–9223372036854775807; strings and booleans are rejected.

Default required

itemsstring[]

1–33 codes from GET /events/types; duplicates removed. Omit or send null for all sections.

Default omitted

include_original_raw_textbool

Include complete original filing text as raw_text, at no additional cost.

Default false

include_exhibitsbool

Include the filing's attachments as exhibits, at no additional cost.

Default false

as_of_dateISO date

Read this filing only if it was filed on or before this date. Must not be in the future.

Default omitted

detailstring

Full and minimal views only: "light" returns the minimal view. With include_original_raw_text or include_exhibits, the full view is returned. See Response detail.

Default "full"

Response: filing (event filing object) with sections (event section objects), available amendments, and raw_text / exhibits when requested; then credits_used and optional _warnings.

items filters only sections. Filing metadata, amendment records and requested original text remain complete. Valid Item codes with no matching sections return sections: [].

Credits: 30 per call, including requests with no matching sections.

Errors: 404 EVENTS_FILING_NOT_FOUND (charged), 404 EVENTS_FILING_NOT_YET_FILED (charged; the filing is later than as_of_date), 403 PLAN_TIER_INSUFFICIENT when the filing is outside your plan (charged) or below Starter, 422 VALIDATION_ERROR, 402 CREDITS_INSUFFICIENT.

curl -X POST https://api.akkrudata.ai/api/v1/events/filing \ -H "X-API-Key: $AKKRU_API_KEY" \ -H "Content-Type: application/json" \ -d '{"filing_id":4688,"items":["5.02"],"include_original_raw_text":false,"include_exhibits":false,"as_of_date":null}'

{ "filing": { "id": 4688, "ticker": "CNP", "issuer_cik": "0001130310", "accession_number": "0001130310-23-000002", "form_type": "8-K", "filing_date": "2023-01-03", "period_of_report": "2023-01-03", "items": [ "5.02", "7.01", "9.01" ], "items_declared": [ "5.02", "7.01", "9.01" ], "merge_status": "confirmed", "source_url_prefix": "https://www.sec.gov/Archives/edgar/data/1130310/000113031023000002/", "sections": [ { "item": "5.02", "title": "Departure of Directors or Certain Officers; Election of Directors; Appointment of Certain Officers; Compensatory Arrangements of Certain Officers", "summary": "On January 3, 2023, CenterPoint Energy, Inc. announced a new organizational structure effective immediately. Chief Executive Officer David J. Lesar continues in his role; President and Chief Operating Officer Jason P. Wells continues and will also serve as Chief Financial Officer until a successor is appointed…", "source_accession": "0001130310-23-000028", "source_filing_date": "2023-02-21", "restated": "modified", "source_locator": "../000113031023000028/cnp-20230217.htm" } ], "amendments": [ { "accession": "0001130310-23-000028", "source_locator": "../000113031023000028/cnp-20230217.htm", "amendment_type": "merged", "amendment_filing_date": "2023-02-21", "sections_added": 0, "sections_restated": 2, "merge_key": "explicit_reference", "amendment_reason": "This Current Report on Form 8-K/A amends our Current Report on Form 8-K filed with the Securities and Exchange Commission on January 3, 2023 and dated as of January 3, 2023." } ] }, "credits_used": 30, "_warnings": [ "Some sections were omitted because the request included items. To retrieve all sections for this filing, omit the items field." ] }