call_report.fca.catalog.construct_fca_download_url#

call_report.fca.catalog.construct_fca_download_url(*, period: ReportingPeriod) → str[source]#

Construct the FCA download URL for a period’s Call Report zip archive.

FCA changed its URL and filename convention between the legacy and modern eras. Periods from 2000 through 2014 use an abbreviated month name under /template-fca/download/CallReportData/. Periods from 2015 onward use the full month name under /template-fca/bank/.

Parameters:

periodReportingPeriod: The period to build a URL for.

Returns:

str: The full URL to that period’s zip archive.

Raises:

PeriodNotAvailableError: If period is before FCA’s first release (2000Q1) or after the quarter containing today’s date.

See also

fca_release_stem: Return the name of a period’s release zip.
parse_fca_release_filename: Turn a release zip’s name back into its period.
construct_fca_mirror_url: Build the GitHub mirror URL of a period’s zip.

Examples

>>> construct_fca_download_url(
...     period=ReportingPeriod.from_period_end(value="2026-03-31")
... )
'https://www.fca.gov/template-fca/bank/2026March.zip'
>>> construct_fca_download_url(
...     period=ReportingPeriod.from_period_end(value="2014-09-30")
... )
'https://www.fca.gov/template-fca/download/CallReportData/Sept2014.zip'