While file reports can be built using the ENA advanced search (as described here), there is a special filereport URL that will return these reports. This URL bypasses the advanced search and fetches information directly from a data cache, increasing the speed of delivery. This faster resource is available using the following URL template:
When the fields parameter is used, only those columns requested are returned and they are in the same order as requested. If the fields parameter is not used, all available columns for the result are returned.
To retrieve the run file report, the result should be set to read_run. Study accessions (ERP, SRP, DRP, PRJ prefixes), experiment accessions (ERX, SRX, DRX prefixes), sample accessions (ERS, SRS, DRS, SAM prefixes) and run accessions (ERR, SRR, DRR prefixes) can be supplied. Available fields are listed under the read_run result in the returnable fields table at the bottom of this page.
To retrieve the analysis file report, the result should be set to analysis. Study accessions (ERP, SRP, DRP, PRJ prefixes), sample accessions (ERS, SRS, DRS, SAM prefixes) and analysis accessions (ERZ, SRZ, DRZ prefixes) can be supplied. Available fields are listed under the analysis result in the returnable fields table at the bottom of this page.
Changing from the legacy file report
We are recommending users change from the old file report URLs given below to use the new URL described above, as ENA is planning to deprecate these older URLs. There are several benefits for this change, the main ones being that the new filereport URL will generate the reports faster than the older URL, and the new URL is expected to be more reliable.
There are several differences in the output of the new report compared to the old:
- The fastq and submitted file information can be returned in the same report rather than having to use the two separate ones as was the case in the old URL format.
- The header will use each field name (these are listed here).
- When no data is available for a field, that column will be empty.
- The columns supplied in the report are user defined rather than set.
- File size is unformatted (the value is given in bytes rather than conversion to Mb/Gb with units).
The following table lists the columns available in the current legacy reports and how they might be converted into the new run/analysis reports.
|Legacy report column||New report column||Available in run report||Available in analysis report|
|Run Read Count||read_count||Y||N|
|Run Base Count||base_count||Y||N|
|File Size||fastq_bytes/submitted_bytes||Y||Y (submitted)|