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 outside FCA’s known-published range (EARLIEST_PERIOD through LATEST_KNOWN_PERIOD).

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'