The Form 18-K Files Dataset is a form-scoped corpus of EDGAR submissions of Form 18-K and Form 18-K/A — the statutory annual reports (and their amendments) prescribed under Section 7 of the Securities Act of 1933 for foreign governments and political subdivisions whose debt securities are registered under Schedule B. One record represents a single accession: the annual report for one fiscal year filed by a sovereign issuer (for example Argentina, Israel, the Philippines, Mexico, Hungary, Uruguay) or by a political subdivision of a foreign government (primarily Canadian provinces such as Quebec, Ontario, British Columbia, Alberta, Manitoba, and New Brunswick). Each accession is materialized as a folder keyed by the 18-digit EDGAR accession number with dashes removed, bundling a metadata.json manifest, the primary *18k.htm or *18ka.htm form document, and every textual exhibit attached to the submission. Coverage begins in May 1997 — when electronic filing of Form 18-K on EDGAR became standard — and runs to the present, spanning both the ASCII/SGML era and the modern HTML-plus-PDF era of sovereign disclosure.
Programmatically retrieve the full list of dataset archive files, download URLs and dataset metadata.
Dataset Index JSON API
Download the entire dataset as a single archive file.
Download Entire Dataset:
Download a single container file (e.g. monthly archive) from the dataset.
Download Single Container:
The dataset packages EDGAR submissions of Form 18-K and its amendment counterpart Form 18-K/A — the annual-reporting instruments that keep Schedule B debt registrations current after a foreign government or political subdivision has registered securities in the United States. Schedule B specifies what must be disclosed when such an issuer registers debt; Form 18-K is the annual post-effective disclosure by which that registration is refreshed. The form itself is a short statutory shell — a cover page followed by a small number of numbered items — that acts as a frame into which the registrant inserts, directly or by reference to attached exhibits, the narrative, legal, and financial updates demanded by Schedule B.
Coverage is the entire Form 18-K filer population on EDGAR from May 1997 to the present, including both base 18-K reports and the frequently-filed 18-K/A amendment stream. Typical registrants include sovereign states (Argentina, Indonesia, Israel, Jamaica, the Republic of Korea, Uruguay), Canadian provinces (Quebec, Ontario, New Brunswick, British Columbia, Nova Scotia), Australian states, and certain supranational or multilateral entities that have issued debt registered on Schedule B. The dataset is distributed as monthly ZIP containers, with file types inside each container limited to TXT, JSON, HTML, and PDF; graphic binaries (JPG, GIF, PNG) referenced by filings are excluded from the packaged folders even though their sequence entries remain visible in the manifest.
One record in the Form 18-K Files dataset is a single EDGAR submission of Form 18-K or Form 18-K/A, materialized as a folder keyed by the 18-digit EDGAR accession number with dashes removed. The folder bundles the complete set of documents belonging to one annual report filing by a foreign government or political subdivision for debt securities registered under Schedule B of the Securities Act of 1933: a metadata.json manifest, the primary form document (typically named *18k.htm or *18ka.htm), and every exhibit attached to the submission. Image files referenced by the filing — photographs, flags, maps, charts rendered as raster graphics — are excluded from the packaged folder, although their sequence entries, types, and EDGAR URLs remain present inside the manifest so the reference structure is preserved. A record therefore contains the full readable substance of the annual report as accepted by EDGAR, minus the binary graphics layer.
Form 18-K is the statutory annual report prescribed under Section 7 of the Securities Act of 1933 in conjunction with Schedule B, the disclosure regime that governs securities issued by foreign governments and their political subdivisions. Schedule B specifies what must be disclosed when such an issuer registers debt in the United States; Form 18-K is the instrument by which that registration is kept current through annual post-effective disclosure. The form itself is a short statutory shell — essentially a cover page followed by a small number of numbered items — that operates as a frame into which the registrant inserts, directly or by reference to attached exhibits, the narrative, legal, and financial updates demanded by Schedule B. Rule 3 of the Form 18-K instructions requires the report to be filed within a reasonable time after the close of each fiscal year covered by the registration; in practice most sovereign issuers file within six to nine months of their fiscal year-end, and many amend multiple times across the following year.
Typical registrants include sovereign states (for example Argentina, Indonesia, Israel, Jamaica, the Republic of Korea, the Oriental Republic of Uruguay), Canadian provinces (Quebec, Ontario, New Brunswick, British Columbia, Nova Scotia), Australian states, and supranational or multilateral entities that have issued debt registered on Schedule B (such as the Council of Europe Development Bank or the Inter-American Development Bank when filing in that capacity). All such filers are assigned the EDGAR SIC code 8888 Foreign Governments regardless of whether they are national, sub-national, or supranational, so the SIC field does not distinguish among them.
Form 18-K/A is the amendment counterpart. Sovereign financial circumstances evolve continuously — new bond issuances off the shelf, revised budgets, shifts in external debt, new debt-authorization laws, updated balance-of-payments data — so it is common for a single fiscal-year 18-K to be followed by several 18-K/A amendments during the subsequent year, each restating or supplementing the base disclosure. Amendment numbering (for example "Amendment No. 2") appears only in free-form cover-page language and exhibit captions; there is no structured amendment-sequence field in the manifest.
A record has two layers that a consumer should distinguish:
metadata.json file and one file per non-graphic EDGAR document entry (primarily HTML, with occasional PDF and legacy TXT artifacts).metadata.json and, for legacy filings, through the SGML <DOCUMENT> markers inside the complete-submission .txt file that EDGAR exposes at linkToTxt.The manifest is the canonical description of the submission's structure and carries the document typing that drives interpretation. The HTML and PDF documents carry the statutory content and the economic narrative.
metadata.json manifestThe manifest is the authoritative key-value description of the filing. Its top-level fields include:
formType — "18-K" or "18-K/A".accessionNo — EDGAR accession number in dashed form; the folder name is the same value with dashes removed.description — a fixed human-readable label identifying the filing as the foreign-government annual report.filedAt — ISO-8601 timestamp with offset recording EDGAR's acceptance.periodOfReport — the fiscal-year-end date the annual report covers, in YYYY-MM-DD form. This is the anchor for matching an 18-K to later 18-K/A amendments covering the same period.linkToFilingDetails — URL to the primary *18k.htm / *18ka.htm document on sec.gov.linkToTxt — URL to the complete-submission .txt file, which concatenates every document in the submission inside SGML <DOCUMENT> wrappers and is the only artifact in which the full SGML structure is visible end to end.linkToHtml — URL to the EDGAR -index.htm listing for the accession.linkToXbrl — empty string for this form type; Form 18-K is not within the XBRL tagging regime.id — pipeline identifier.seriesAndClassesContractsInformation, dataFiles — empty arrays for this form type.Two sub-arrays carry the structural detail:
documentFormatFiles — one entry per document, graphic, or aggregate artifact in the original EDGAR submission. Each entry carries sequence (1-based ordering), size (bytes, string-encoded), documentUrl (EDGAR location), type (EDGAR document-type label such as 18-K, 18-K/A, EX-5, EX-99.1, EX-99.D, GRAPHIC, or blank for the aggregate .txt submission record), and an optional free-form description that echoes what the filer wrote on the EDGAR document cover. Graphic entries remain in this array even though the binaries are not packaged in the dataset folder.entities — one entry per filer on the submission. For Form 18-K this is typically a single sovereign or sub-sovereign issuer. Each entry carries cik, companyName (with a parenthetical role suffix such as (Filer)), fiscalYearEnd in MMDD form, fileNo (the SEC file number tying the filing to the underlying Schedule B registration statement — the 333- series for Securities Act registrations), act (typically "34" as recorded by EDGAR's header parser, even though the underlying registration authority for these filers is Schedule B of the 1933 Act), type (the form type echoed at the entity level), sic (uniformly 8888 Foreign Governments), filmNo, irsNo (typically 000000000 for sovereigns and sub-sovereigns that hold no US taxpayer identifier), and, when reported, stateOfIncorporation holding the EDGAR two-character country or jurisdiction code (for example K8 for Indonesia, A8 for Quebec, C3 for Argentina).The primary *18k.htm / *18ka.htm file carries the statutory shell of Form 18-K itself. Its HTML body renders the statutory cover page followed by the numbered items. The cover page reproduces the "UNITED STATES / SECURITIES AND EXCHANGE COMMISSION / FORM 18-K / ANNUAL REPORT OF <Registrant>" heading, the name of the registrant, the fiscal year covered, the table of securities registered under Schedule B (title of issue, amount as to which registration is effective, and names of any exchanges on which the securities are listed), and the name and address of the authorized agent for service of process or recipient of notices in the United States.
Below the cover, the form presents the statutory items in the order prescribed by the form instructions. These items are short in textual footprint but load-bearing:
The primary document closes with the signature block, identifying the signing officer (often a minister of finance, director of debt management, secretariat official, or US-based authorized representative) and the date. Much of the actual economic and financial disclosure demanded by Schedule B is not inlined; instead the primary document references exhibits via "incorporated herein by reference" language, with an exhibit list at the end enumerating each attachment by exhibit number and caption.
Exhibits carry the substantive narrative and hold the great majority of the filing's byte weight. In documentFormatFiles, the type field records the exhibit label (EX-5, EX-99, EX-99.1, EX-99.D, EX-99.C-XI, and the like), and description holds the plain-English caption. Typical exhibit categories include:
EX-99.D or a numbered EX-99.*) — usually the largest single document in the filing, frequently running into the megabytes. It contains the comprehensive economic and fiscal profile of the registrant: geography and population; political and constitutional framework; the economy (GDP composition, sectoral activity, employment, inflation, monetary and exchange-rate policy); the external sector (balance of payments, foreign trade, foreign direct investment, reserves, exchange-rate regime); public finance (national receipts and expenditures, tax structure, the latest annual budget); public-sector debt (tables of internal and external debt by instrument, currency, maturity, and holder); and the financial system.EX-99.EX-5) — the legal opinion on the validity of the registered securities, typically signed by a Ministry of Justice counsel, attorney general, solicitor general, or outside US counsel engaged by the sovereign.EX-99.*) — auditor or expert consents, supplemental financial tables, press releases, or prospectus supplements tied to takedowns from the shelf.Exhibit file names follow the filing agent's convention rather than a uniform scheme. Donnelley files typically use d<jobnumber>d18k.htm and d<jobnumber>dex99d.htm; Toppan Merrill files use tm<jobnumber>_18ka.htm and tm<jobnumber>_ex5.htm; self-filers and other agents use patterns such as ponb_18ka.htm / ponb_ex996.htm or form18ka.htm / exhibit99-5.htm. Filenames are therefore not a reliable classifier; documentFormatFiles.type is authoritative.
Every EDGAR submission is internally organized as an SGML envelope in which each component document is enclosed by a <DOCUMENT>...</DOCUMENT> block carrying <TYPE>, <SEQUENCE>, <FILENAME>, <DESCRIPTION>, and <TEXT> tags around the payload. That full SGML structure is visible end-to-end in the complete-submission .txt file referenced by linkToTxt, which concatenates every document in the submission into a single SGML stream. A representative wrapper around the primary form looks like:
1
<DOCUMENT>
2
<TYPE>18-K
3
<SEQUENCE>1
4
<FILENAME>d90705d18k.htm
5
<DESCRIPTION>18-K
6
<TEXT>
7
<HTML>...</HTML>
8
</TEXT>
9
</DOCUMENT>
The individual .htm files that EDGAR exposes (and that the dataset packages) generally contain only the HTML payload without the surrounding SGML tags; the per-document typing is instead reconstructed from metadata.json or by parsing the .txt submission. Consumers that want per-document TYPE, SEQUENCE, and FILENAME attributes without re-fetching the .txt should rely on the manifest's documentFormatFiles array, which preserves exactly the same information.
A record includes: the metadata.json manifest; the primary form document as an HTML file; and every textual exhibit attached to the submission. The file-types found in the dataset are TXT, JSON, HTML, and PDF, with HTML plus the JSON manifest dominating modern filings and PDF appearing for scanned legal or budget documents. Legacy filings from the late 1990s and early 2000s are often plain ASCII .txt files rather than HTML; these are preserved in their original form.
Graphic files (EDGAR document type GRAPHIC — JPG, GIF, PNG) are excluded from the packaged folder. Their sequence entries, types, sizes, and documentUrl values remain in documentFormatFiles so consumers can trace image references back to the original EDGAR submission and fetch the binaries directly from sec.gov when needed. No XBRL or inline-XBRL file set exists because Form 18-K has never been brought into the structured-financial-data regime that applies to 10-K and 10-Q filings.
Schedule B of the Securities Act of 1933 has defined the disclosure framework for foreign-government debt since 1933, and Form 18-K has operated as the annual-reporting companion to Schedule B registrations throughout. The statutory items on the face of the form — material modifications to holder rights, payment defaults, and totals of internal and external funded debt — have been stable for decades. What has shifted over time is the convention for how much Schedule B substance sits on the face of the form versus inside exhibits. Modern filings almost uniformly inline only the statutory items and push the Description of the Republic, the budget, the debt tables, and the legal opinions into EX-99.* attachments, with the primary document acting largely as a short cover form that incorporates the exhibits by reference. Older filings more often included substantial narrative inside the primary document body.
The exhibit set has also diversified as sovereign disclosure practice has matured. It is now common to see separate exhibits for the Description of the Issuer, the budget, the relevant laws, supplemental consents, and the opinion of counsel, whereas earlier filings often bundled these materials into a single omnibus exhibit. 18-K/A amendment volume has grown alongside the rise of active sovereign shelf programs: frequent issuers update their base 18-K multiple times per year as new takedowns, restructurings, or material economic events require the registration file to be refreshed.
Form 18-K filings in the dataset cover the period from May 1997 to the present, and format evolution tracks EDGAR's general trajectory:
<DOCUMENT> wrapper was already in place inside the complete-submission .txt, but the payload between <TEXT> and </TEXT> was unformatted text rather than HTML.Several nuances matter for downstream use:
cik and fileNo) and periodOfReport, then ordering by filedAt. Amendment numbers appear only inside cover-page prose.*18k.htm is typically short; substantive economic, fiscal, and legal content lives in the exhibits. Any text-extraction pipeline must concatenate the exhibits to reconstruct the full disclosure.d<n>d..., Toppan Merrill tm<n>_..., various self-filer patterns); always use documentFormatFiles.type rather than filename heuristics to identify exhibits.8888 Foreign Governments SIC. Distinguishing national from sub-national from supranational registrants requires reading companyName and, when present, stateOfIncorporation.act value 34 is an EDGAR header artifact, not a legal classification. The underlying registration authority for Schedule B filers is the Securities Act of 1933; the "34" value on entities[*].act reflects how EDGAR's submission header captures these filings and should not be read as an Exchange Act registration.documentFormatFiles have resolvable documentUrl values pointing to sec.gov even though the files are not inside the folder; consumers needing the graphics must fetch them separately.documentFormatFiles.type and can be processed independently; the manifest's sequence ordering reconstructs the original submission order across the folder.Each record is an annual report on Form 18-K, or an amendment on Form 18-K/A, filed by a foreign government or a political subdivision of a foreign government that has registered debt securities with the SEC under Schedule B of the Securities Act of 1933. The reporting person is the sovereign or sub-sovereign entity itself, not a state-owned corporation domiciled abroad.
The filing population falls into two narrow groups:
Underwriters, fiscal agents, U.S. authorized representatives, and counsel appear in the filings in signatory or representative capacities only; they are not the reporting persons.
Both Schedule A and Schedule B sit within the Securities Act of 1933. Section 7 of the Securities Act directs that registration statements for securities issued by a foreign governments and political subdivisions thereof be prepared in accordance with Schedule B, which enumerates information on public debt, revenues and expenditures, and the terms of the securities. Schedule A governs registration by corporate and other private issuers.
Form 18-K is the annual report form for Schedule B registrants. Its items are defined by the form's General Instructions and by reference to Schedule B, covering the statement of public debt, receipts and expenditures, material modifications to the rights of holders of registered securities, and trade and balance-of-payments data. There is no foreign-sovereign equivalent to Regulation S-K.
Boundary with the F-series. Foreign private issuers that are operating companies register on Forms F-1, F-3, or F-4 under Schedule A and report annually on Form 20-F. Canadian corporate issuers using the Multijurisdictional Disclosure System file on Form 40-F. MJDS is a corporate-issuer regime: Canadian provinces are not eligible for 40-F and instead file Form 18-K as political subdivisions under Schedule B. Sovereigns and their subdivisions fall outside the Rule 405 definition of "foreign private issuer" and therefore cannot use 20-F or 40-F.
Form 18-K is periodic and annual, tied to the registrant's fiscal year end.
Filing dates cluster by fiscal calendar: calendar-year filers (December 31 close) typically file in mid-to-late the following year; Canadian provinces on an April 1 to March 31 fiscal year generally file in the second half of the following calendar year. Schedule B registrants do not file quarterly reports or current reports; there is no sovereign analog to Form 10-Q or Form 8-K.
Form 18-K/A is event-driven, not scheduled. An amendment is filed whenever the registrant needs to update, correct, or supplement the most recent annual report. Typical triggers include:
Because sovereigns lack a current-report mechanism, active issuers often file multiple 18-K/A amendments per fiscal year, effectively using the amendment path as a continuous-disclosure channel for their registered debt programs.
Form 18-K sits in a small, distinct corner of EDGAR defined by issuer type (sovereign / sub-sovereign, not corporate) and registration regime (Schedule B, not Schedule A). The useful comparisons are therefore with other annual-report forms that share the "annual" label but cover different issuers, the companion Schedule B registration form, and the current-report regimes that have no Schedule B analog.
Exchange Act annual report for U.S. domestic corporations, built on Regulation S-K and Regulation S-X: GAAP financial statements, MD&A, risk factors, executive compensation, ICFR attestation, governance. None of this applies to a sovereign. Form 18-K reports national receipts and expenditures, public debt statements, and trade and balance-of-payments data drawn from government fiscal accounts. Deadlines also differ: Form 10-K is due 60–90 days after fiscal year end depending on filer status; 18-K allows up to nine months (a Schedule B convention reflecting the pace of sovereign fiscal reporting). Disjoint issuers, disjoint content.
Annual report for non-U.S. corporate issuers (foreign private issuers) registered under the Securities Act's corporate regime, with Schedule A-based content requirements adapted for IFRS or home-GAAP reconciliation and home-country regulatory, tax, and exchange-control disclosures. Deadline is four months after fiscal year end. 20-F is the closest "foreign" annual report to 18-K but remains a corporate form: different issuer (private-sector company, not government), different schedule, different content, different deadline. Research on non-U.S. corporate issuers uses 20-F; research on sovereign debt issuers uses 18-K.
Annual report for eligible Canadian reporting issuers under the U.S.–Canada Multijurisdictional Disclosure System, which lets qualifying Canadian corporate issuers satisfy U.S. annual reporting largely by wrapping their Canadian continuous-disclosure package. MJDS is a corporate-issuer accommodation; it does not extend to sovereign or sub-sovereign debt issuers. Canadian provinces (Ontario, Quebec, British Columbia, Alberta, Manitoba, and others) and the Government of Canada, when they tap U.S. debt markets, register under Schedule B and file Form 18-K — not 40-F. The split is by registration regime, not nationality: a Canadian corporation files 40-F; a Canadian province files 18-K alongside sovereigns such as Israel, Japan, Mexico, and Italy.
Form 18 is the one-time registration statement foreign governments and political subdivisions file when initially registering debt securities under Schedule B. Form 18-K is its annual update. Form 18 establishes the baseline — description of the securities, public debt profile, fiscal and economic background, authorizing laws — and Form 18-K refreshes it each year with updated debt statements, budget data, any material modifications to security holder rights, and current exhibits (latest budget, new laws or decrees). Complements, not substitutes: a Form 18 dataset captures registration events; the 18-K dataset captures the ongoing annual stream.
Form 8-K is the event-driven current report for U.S. domestic issuers; Form 6-K is its foreign private issuer counterpart, used to furnish information a foreign corporate issuer makes public at home. Neither reaches Schedule B sovereign registrants — there is no dedicated sovereign current-report form. In practice, 18-K/A amendments carry much of the intra-year update load: when a sovereign issues new material information or updates debt or budget data between annual cycles, it files an 18-K/A. Unlike a Form 10-K/A, which is essentially a correction vehicle, 18-K/A also functions as the Schedule B intra-year update mechanism, which is why 18-K/A volume is substantial relative to the underlying 18-K base. Researchers wanting event-time sovereign disclosures should mine 18-K/A filings, not hunt for a sovereign 8-K.
The cross-cutting distinction is statutory. Schedule A of the Securities Act of 1933 sets the content requirements for registration by corporate and other non-governmental issuers — the universe behind Forms S-1, F-1, and, via the Exchange Act and related rules, 10-K, 20-F, 40-F, 8-K, and 6-K. Schedule B of the 1933 Act sets a separate, much shorter content list for foreign governments and political subdivisions, focused on public debt, revenues and expenditures, trade data, and the securities being offered. Form 18 (registration) and Form 18-K (annual update) are the only filings native to Schedule B. Schedule A corporate annual reports and Schedule B sovereign annual reports are not interchangeable at any level — the statutory content requirements, filer types, and disclosure structure are fundamentally different.
Supranational development banks are neither corporations nor sovereigns. Their U.S. securities offerings are generally exempt from Securities Act registration under their enabling statutes or bilateral agreements, so they do not use Schedule B (which is reserved for "foreign governments" and their "political subdivisions"). Instead they file periodic information reports and prospectus supplements on EDGAR under form types such as "ANNLRPT" (annual report of supranational) and related informational forms, not Form 18-K. A supranational-issuer dataset sits adjacent to, but outside, the 18-K universe; users studying the full sovereign-plus-supranational U.S. debt disclosure landscape need both.
Form 18-K is defined by the intersection of three narrow conditions: the issuer is a foreign government or political subdivision, the securities are registered under Schedule B of the 1933 Act, and the filing is the annual update (with 18-K/A covering both corrections and material intra-year updates). It is not substitutable by corporate annual reports (10-K, 20-F, 40-F), which cover different issuers under Schedule A; not substitutable by current-report regimes (8-K, 6-K), which do not reach Schedule B filers; complementary to, not a replacement for, Form 18, which captures the one-time registration; and distinct from supranational filings, which operate under exemption. For any question about the fiscal condition, public debt profile, or annual disclosure of sovereign and sub-sovereign SEC-registered debt issuers — including Canadian provinces — the 18-K dataset is the primary and largely exclusive source.
Form 18-K bundles sovereign annual disclosure under Schedule B: statements of public debt, receipts and expenditures, balance-of-payments tables, budget exhibits, legal opinions, and amendments to outstanding securities. The professional users below each draw on specific parts of that record.
Analysts at rating agencies, sell-side sovereign desks, and buy-side credit teams pull the statements of public debt (internal vs. external, by currency, creditor class, and maturity ladder), receipts and expenditures, reserves, and balance-of-payments tables to feed debt-to-GDP, debt-service, and amortization-profile metrics used in rating committee memos and published credit opinions. The 18-K/A stream captures restated fiscal data and corrections between annual cycles; budget exhibits reconcile prior-year outturn against forward appropriations.
PMs running dedicated EM sovereign or blended hard/local-currency mandates use the public-debt schedules to stress-test rollover risk and FX mismatch against benchmark positions. Cross-vintage comparison of fiscal and external accounts confirms whether trajectory assumptions in internal sovereign scorecards still hold; 18-K/A amendments drive decisions on position sizing, duration, and hedging.
Bankers advising sovereign issuers and syndicate desks pricing new supply mine prior 18-K filings for the registered shelf, outstanding issuance stack, and documented modifications to existing securities. The "material modifications to rights of security holders" section and the exhibits covering amendments to outstanding securities feed reopening mechanics, consent solicitations, and liability management work. Peer-sovereign filings anchor relative-value and disclosure-precedent arguments on new deals.
Counsel advising sovereign issuers on Schedule B registration and ongoing disclosure use the corpus to benchmark drafting conventions: how peers describe public debt, legal authority to borrow, use of proceeds, and material modifications. Legal opinion exhibits and attached laws or decrees serve as precedent, and the 18-K/A history supports curing and refreshing shelf documentation.
Country risk teams at global banks, macro funds, multilateral lenders, and policy research groups treat 18-K as a cadence-driven source of issuer-certified fiscal and external data. Receipts, expenditures, trade, BoP, reserves, and public-debt tables feed country risk scorecards and early-warning models, serving as a reference when domestic official publications, Article IV data, and market data diverge.
Researchers use the 1997-present record as a longitudinal panel. Budget exhibits and public-debt statements support consistent series on debt stocks, creditor composition, and fiscal aggregates across sovereigns and decades. Legal exhibits provide primary-source material for work on collective action clauses, governing-law choices, and changes to bondholder rights.
Distressed-sovereign desks monitor 18-K and 18-K/A flow for early signals of fiscal deterioration, shifts in creditor composition, or modifications to outstanding instruments. The amendments exhibits, public-debt narrative, and restated expenditure data support restructuring diligence timelines, CAC analysis, and holdout-risk assessments.
Compliance and onboarding teams at broker-dealers, custodians, and asset managers use the metadata.json manifest and cover page to confirm registrant identity, fiscal-year end, filing timeliness against the nine-month deadline, and presence of 18-K/A amendments. Descriptions of material modifications and amendments to outstanding securities feed reference-data and security-master updates.
Engineers building sovereign reference data, document search, or retrieval-augmented generation systems use the dataset as a form-scoped corpus. The per-accession metadata.json and document inventory support deterministic ingestion; textual exhibits (budget narratives, laws and decrees, legal opinions, public-debt schedules) suit sovereign-specific QA, clause extraction, and cross-filing comparison. Stable scope (all 18-K and 18-K/A, 1997-present, images excluded) makes extraction contracts and eval sets reproducible.
DMOs and their external advisers use the dataset to benchmark peer disclosure: how comparable sovereigns structure public-debt tables and budget exhibits, describe material modifications, and handle amendments. This informs the next annual 18-K cycle, especially for sensitive items such as contingent liabilities, guarantees, and multilateral obligations.
The common thread: Form 18-K is the securities-law-grade annual disclosure for foreign sovereign debt registered in the United States. Credit analysts, EM PMs, DCM bankers, disclosure counsel, country risk researchers, academics, restructuring desks, compliance teams, data engineers, and DMO benchmarkers each work a different slice of the same filings — public debt statements, fiscal and external accounts, budget and legal exhibits, bondholder-rights modifications, and the metadata manifest.
The workflows below draw directly on the filings' actual content — the statements of funded debt on the primary form, the EX-99.D Description exhibits, budget and legal attachments, 18-K/A amendment streams, and the metadata.json manifest — rather than on the dataset in the abstract.
Extract the "total amounts of internal and external funded debt outstanding" tables from the primary *18k.htm and the corresponding public-debt schedules in the EX-99.D Description exhibit for every fiscal-year 18-K filed by recurring issuers (Argentina, Mexico, Israel, the Philippines, Hungary, Uruguay, Jamaica, Quebec, Ontario). Normalize by currency, instrument class, and maturity bucket, then key on entities[*].cik and periodOfReport to stitch a sovereign-by-sovereign time series that feeds debt-to-GDP trajectories, amortization ladders, and external-debt FX-mismatch stress tests.
Group filings by cik + fileNo + periodOfReport and order by filedAt to reconstruct each sovereign's 18-K → 18-K/A amendment chain for a given fiscal year. Parse the "material modifications to the rights of holders" item plus any EX-99 exhibits captioned as amendments, supplemental indentures, or consent solicitations to drive a monitor for new shelf takedowns, reopenings, exchange offers, and CAC-based modifications — the primary intra-year disclosure surface for Schedule B issuers, since there is no sovereign 8-K.
For counsel drafting or DMOs preparing the next annual filing, pull the most recent 18-K from a curated peer set (for example, Ontario vs. Quebec vs. British Columbia; or Indonesia vs. Philippines vs. Malaysia) and diff the Description-of-the-Issuer exhibits on specific sections: contingent liabilities, guaranteed debt, multilateral obligations, governing-law and jurisdiction clauses, and the public-debt table format. Use documentFormatFiles.type (not filenames) to locate EX-99.D and the legal opinion EX-5 across agents (Donnelley, Toppan Merrill, self-filers).
Filter documentFormatFiles for type == "EX-5" to harvest the opinion-of-counsel exhibits signed by ministries of justice, attorneys general, or outside US counsel, and for EX-99 exhibits captioned as laws, decrees, or borrowing authorizations to collect appropriation acts, fiscal-responsibility statutes, and debt-management laws (including scanned-PDF originals). The result is a primary-source corpus for research on collective-action clauses, governing-law choices, and changes to bondholder rights across jurisdictions.
From the EX-99.D Description exhibit, extract the recurring sub-sections on national receipts and expenditures, the latest annual budget (prior-year outturn vs. forward appropriations), external trade, balance of payments, reserves, and the exchange-rate regime. Align these on periodOfReport to feed country-risk scorecards and early-warning models with issuer-certified data that is directly comparable over time and independent of IMF Article IV or national statistical-office publication lags.
Use metadata.json as the deterministic manifest for ingestion: accessionNo as the primary key, documentFormatFiles to enumerate HTML/PDF payloads (skipping GRAPHIC entries), entities[*].stateOfIncorporation and companyName for issuer tagging, and periodOfReport for temporal filtering. Index the primary form plus the EX-99.D, budget, and EX-5 exhibits to power retrieval-augmented QA over sovereign public-debt narrative, budget line items, and legal-opinion language, with stable scope (1997-present, all 18-K and 18-K/A, images excluded) that makes extraction contracts and eval sets reproducible.
Consume the manifest fields — cik, fileNo (the Schedule B 333- registration number), fiscalYearEnd, filedAt, and formType — to populate issuer reference data, confirm each sovereign's fiscal-year-end and filing timeliness against the nine-month Schedule B convention, and flag accessions where the "material modifications" item or an amendment exhibit indicates a change that should propagate into security-master records for already-outstanding registered instruments.
Dataset Index JSON API: https://api.sec-api.io/datasets/form-18k-files.json
The dataset index endpoint returns metadata describing the Form 18-K Files Dataset, including its name, description, last updated timestamp, earliest sample date (1997-05-01), total record count, total size, covered form types (18-K and 18-K/A), container format (ZIP), and the content file types inside each container (TXT, JSON, HTML, PDF). It also returns the download URL for the full dataset archive and the list of individual monthly container files, each with its size, record count, last updated timestamp, and download URL. This endpoint does not require an API key. It is useful for monitoring which containers have been updated in the most recent refresh run, allowing you to decide on a daily basis which containers to re-download.
Example response:
1
{
2
"datasetId": "1f13365b-9ae0-6965-89d4-b8b4f6381214",
3
"datasetDownloadUrl": "https://api.sec-api.io/datasets/form-18k-files.zip",
4
"name": "Form 18-K Files Dataset",
5
"updatedAt": "2026-04-24T02:56:00.191Z",
6
"earliestSampleDate": "1997-05-01",
7
"totalRecords": 12663,
8
"totalSize": 993371160,
9
"formTypes": ["18-K", "18-K/A"],
10
"containerFormat": "ZIP",
11
"fileTypes": ["TXT", "JSON", "HTML", "PDF"],
12
"containers": [
13
{
14
"downloadUrl": "https://api.sec-api.io/datasets/form-18k-files/2026/2026-04.zip",
15
"key": "2026/2026-04.zip",
16
"size": 8421573,
17
"records": 42,
18
"updatedAt": "2026-04-24T02:56:00.191Z"
19
}
20
]
21
}
Download Entire Dataset: https://api.sec-api.io/datasets/form-18k-files.zip?token=YOUR_API_KEY
Use this URL to download the complete Form 18-K Files Dataset as a single ZIP archive containing all monthly containers from 1997 through the current month. This endpoint requires an API key.
Download Single Container: https://api.sec-api.io/datasets/form-18k-files/2026/2026-04.zip?token=YOUR_API_KEY
Use this URL pattern to download one individual monthly container instead of the full dataset. Replace the year and month segments with the container you need, based on the key values returned by the dataset index JSON API. This endpoint requires an API key.
The dataset covers Form 18-K and its amendment counterpart Form 18-K/A — the statutory annual report (and amendments) prescribed under Section 7 of the Securities Act of 1933 for foreign governments and political subdivisions whose debt securities are registered under Schedule B. It does not include initial Schedule B registration statements (Form 18), which are the one-time registration companion.
One record represents a single EDGAR submission of Form 18-K or Form 18-K/A, materialized as a folder keyed by the 18-digit accession number with dashes removed. The folder contains a metadata.json manifest, the primary *18k.htm or *18ka.htm form document, and every textual exhibit attached to the submission (legal opinions on EX-5, Description-of-the-Issuer exhibits on EX-99.D, budgets, laws, and so on).
Form 18-K is filed by foreign governments and political subdivisions of foreign governments that have registered debt securities with the SEC under Schedule B. The population is narrow: sovereign nations with SEC-registered debt (such as Argentina, Mexico, Israel, the Philippines, Hungary, Uruguay, Korea) and political subdivisions, primarily Canadian provinces (Quebec, Ontario, British Columbia, Alberta, Manitoba, New Brunswick). State-owned corporations do not file 18-K; they register under Schedule A and report on Form 20-F.
Rule 3 of Form 18-K requires the report to be filed "within a reasonable time" after the close of the registrant's fiscal year — there is no fixed statutory deadline equivalent to the 60/90/120-day clocks for domestic filers. In practice sovereigns file within roughly six to nine months after fiscal-year end. Form 18-K/A amendments are event-driven rather than scheduled and are often used as the intra-year continuous-disclosure channel, since Schedule B filers have no current-report form analogous to 8-K.
The dataset covers Form 18-K and 18-K/A filings from May 1997 — when electronic filing of Form 18-K on EDGAR became standard — through the present. Earlier paper filings under the same Schedule B framework are not captured.
The dataset is distributed as monthly ZIP containers accessed through the https://api.sec-api.io/datasets/form-18k-files.json index endpoint. Inside each container, file types are limited to TXT, JSON, HTML, and PDF — plain-ASCII legacy submissions from the late 1990s and early 2000s, the metadata.json manifest per record, HTML for modern primary documents and exhibits, and PDF for scanned legal instruments and budget books. Graphic binaries (JPG, GIF, PNG) are excluded from the packaged folder, though their sequence entries remain referenced in documentFormatFiles.
Form 20-F is the annual report for non-U.S. corporate issuers (foreign private issuers) registered under Schedule A; Form 40-F is the Canadian corporate annual report under the U.S.–Canada Multijurisdictional Disclosure System. Both are corporate-issuer regimes. Form 18-K is the annual report for foreign governments and political subdivisions under Schedule B — a different statutory schedule, a different filer universe (sovereigns and sub-sovereigns rather than corporations), and different disclosure content (public debt, receipts and expenditures, balance of payments rather than GAAP/IFRS financial statements, MD&A, and governance). Canadian provinces file 18-K, not 40-F.