Additional Information about the PDD Public Web Service (PWS)

The Public Data Distribution (PDD) Public Web Service (PWS) allows a user to automatically retrieve public data contained in the Central Data Repository (CDR) either through the users’ own programs or the programs provided. The user must have an account before proceeding to access the PWS. When the user initially establishes an account, an email will be sent containing the user name, security token, and instructions for using the web service. After a year of inactivity, the account will be removed and the user will have to register again.

Currently, the PWS will allow a limited number of downloads (approximately 2500 per hour). If the download limit has been reached within one hour, the user will have to wait until the next hour to continue with the next download.

Depending on the request, the files are either in Portable Document Format (PDF), Semicolon Delimited Format (SDF), or eXtensible Business Reporting Language (XBRL) format. SDF text files can be viewed and modified using spreadsheet or database software (e.g., Excel, Access) or with a text editor (e.g., NotePad). XBRL files require an XBRL editor.  A taxonomy may have to be downloaded after the XBRL files have been downloaded for a better understanding of the file. The taxonomy may be accessed through the PDD web site.

Samples of software to use with the PWS are available by accessing the tab entitled “Software Downloads” under Manage My Web Service Account.

When retrieving data for a new reporting cycle, we recommend using the RetrievePanelOfReporters method to first obtain a list of valid banks required to submit for the given reporting period. This method returns a list of ID RSSDs and whether they've already submitted for that period.

For subsequent retrievals for a reporting cycle, we recommend incorporating one of the two methods for retrieving a list of banks that have submitted their Call Report since a certain date:
RetrieveFilersSinceDate - returns a list of ID RSSDs
RetrieveFilersSubmissionDateTime - returns a list of ID RSSDs and the date/time they submitted

You can find a description, endpoint URL and other information for each of the available REST APIs in the PWS API specification document.