/api/v1/filings/eventsGETEvery observed change across the filings tape, oldest first: first sightings, status flips, and later attachments.
Authorization
bearerAuth *Bearer <token>
Session token from the app, or an API key (the
ak_ prefix), sent as a Bearer token or an ?api_key= query parameter.. Token in: headerQuery Parameters
since_seq?integer (int64)
Return only events after this tape position.
since?string (date-time)
Return only events observed at or after this RFC 3339 timestamp.
kind?"received" | "status_changed" | "documents_added"
Return only events of this kind.
feed?string
Return only events on filings in this registry.
page?integer
Default:
1per_page?integer
Default:
100Max: 500Response
200 · A page of filing events, oldest first.
data *object[]
Show item properties
seq *integer (int64)
Position on the tape. Send the highest value a page returned back as since_seq to read only later events.
filing_id *integer (int64)
kind *"received" | "status_changed" | "documents_added"
received is the first sighting, status_changed a listing status flip, documents_added a later attachment.
from_status?string
Status before the flip. Present on status_changed.
to_status?string
Status after the flip. Present on status_changed.
from_doc_count?integer
Attachment count before the addition. Present on documents_added.
to_doc_count?integer
Attachment count after the addition. Present on documents_added.
date?string (date)
CFTC-published date for the action. Present on received and status_changed. Absent on documents_added, which the CFTC listing does not date; order those by observed_at.
observed_at *string (date-time)
When the poll cycle saw the change.
filing *object
Show properties
id *integer (int64)
CFTC filing id.
title *string
Product name on DCM product filings, otherwise the filing description.
feed *"ptc_dcm_rules" | "dcm_products" | "dco" | "dco_rules"
org_code *string
description?string
Rules-feed description. Omitted on DCM product and DCO rows; use title.
product_name?string
DCM product name. Omitted on rules and DCO rows; use title.
product_type?string
DCM product type. Omitted on feeds that do not list one.
category?string
DCM product category. Omitted on rules and DCO rows.
subcategory?string
DCM product subcategory. Omitted on rules and DCO rows.
products_affected?string
PTC listing column. CFTC leaves it blank; omitted when empty.
remarks?string
Present on DCO registrations. Omitted when CFTC published none.
receipt_date?string (date)
Official receipt date on rules feeds. Omitted on DCM products and DCO rows; CFTC does not publish one there.
status *string
status_date *string (date)
doc_count *integer
predicted_effective_date?string (date)
Business-day estimate for a pending rules filing that has a receipt date. Omitted once the filing is no longer pending, and on feeds with no receipt date.
first_seen_at?string (date-time)
last_seen_at?string (date-time)
meta *object
Show properties
total?integernull
Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000).
page?integer
The 1-based page number this response covers.
per_page?integer
Maximum number of items on a page. The last page may hold fewer.
total_pages?integernull
Total number of pages available at the current per_page. null whenever total is null; page using has_next.
has_next?boolean
True when a page exists after this one.
has_prev?boolean
True when this is not the first page.
total_capped?boolean
True when
total and total_pages reflect the server's counting ceiling rather than the exact matched count: the real set is at least total large. Render such totals as a lower bound (for example "10,000+"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag.