Skip to main content
U.S. flag

An official website of the United States government

Official websites use .gov
A .gov website belongs to an official government organization in the United States.

Secure .gov websites use HTTPS
A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites.

Viewing Submission History

Submission History allows you to access all versions of data files previously submitted for a given quarter via the TANF Data Portal (TDP).

How to View Submission History

  1. Search for the reporting period to view


    On the Data Files page, you can complete the search fields for ‘File Type’ (if your program submits both TANF & SSP data), ‘Fiscal Year’, and ‘Quarter’ to identify which data you’ll be viewing.

    Data Files search with emphasis on File Type, Fiscal Year, and Quarter fields as well as the Search button

  2. Select the "Submission History" tab


    After searching for the reporting period, a new button group labelled 'Current Submission' and 'Submission History’ will appear below the 'Search' button.

    The button ‘Current Submission’ is default selected. Navigate to the ‘Submission History’ button to view the data files previously submitted through TDP.

    Submission history page listing five visible previous submissions with more accessible via a pagination control below the current page of the table

Download Error Reports and Previously Submitted Data Files

To access error reports for each file you submit. Click on the link in the ‘Error Report’ column to view errors and data feedback associated with that version of the file. Depending on the completeness of your data and how soon you access the Submission History tab after submitting a file you may see other values in this column including "Pending" and "No Errors".

To access a file previously uploaded to TDP from 'Submission History', you can click the link in the ‘File Name’ column. Note: TDP will auto-rename files to specify the fiscal period and section (e.g. 2021.Q1.Active Case Data), so depending on your original file-naming conventions, the files you download may have a different name.

Submission history table with the file name column emphasized

Understanding File Statuses and Aggregate Data

The Submission History table includes a status which communicates the level of completeness of each file and related aggregate data about its contents including counts of cases with and without errors, counts of records unable to process within a file, and (for section 3 and 4 data) a count of total errors in the file.

Submission history table with aggregate values and the status emphasized
File Statuses Key
Status Description
Pending Your file is being processed by TDP. If this persists for more than two hours, please reach out to TANFdata@acf.hhs.gov for support. Data files submitted prior to February 2024 may show as Pending. No action is needed to correct this, but if you would like to receive an error report for affected files you may resubmit them.
Accepted Your file has been processed and no errors were detected by TDP. Note that OFA may still reach out to you via email with additional feedback on your data.
Accepted with errors Your file was processed but some cases within your data contain errors.
Partially accepted with errors Your file was unable to fully process. This means that some of the records in the file were not accepted, and some records were accepted but contain errors.
Rejected Your file could not be processed and likely contains errors relating file structure/record layout.
Aggregate Data Columns Key
Column Name Description
Cases Without Errors The total number of unique cases for a given reporting month in your file which TDP did not detect any associated errors. Note that OFA may still reach out to you via email with additional feedback on your data.
Cases With Errors The total number of unique cases for a given reporting month in your file that have one or more error associated with them. This likely indicates problems with your data, such as having values outside those defined in the TANF/SSP Coding Instructions or Tribal TANF Coding Instructions.
Records Unable To Process The total number of records within your file that the system was not able to "read" to check for errors. This likely indicates problems with the layout and coding of data within your file. Common reasons that records are unable to be processed include: submitting files with an unexpected record layout (e.g. if an active file is submitted as a closed data file), or the submitted file has records that do not have the expected record length (e.g. if a T6 record has a record length that is less than 379 positions).
Total Errors Since section 3 and 4 data contain aggregate values in one record (rather than case data with many records), TDP can only provide the total number of errors detected in the record. Errors here likely relate to values outside those defined in the TANF/SSP Coding Instructions or Tribal TANF Coding Instructions and/or inconsistencies in the values between related elements for a given reporting month.