List

List

Lists all Form 7004 returns in TaxBandits that have been created and transmitted for a particular BusinessId. Based on the filters supplied in the request, the results will be listed. If you provide a BusinessId, all returns created under that BusinessId will be listed.

GET Form7004/List 

Request Params

Field	Type	Description
BusinessId	Guid	Unique identifier of a business
PayerRef	string	Payer reference of the business
EIN	string	List the 7004 records based on the given TIN
EfileStatus	string	List the 7004 records based on the status ("CREATED, TRANSMITTED, ACCEPTED, REJECTED")
TaxYear	string	List the 7004 records based on the given tax year. Allowed values "2025"
Page	number	Pulls the records listed in the page selected
PageSize	number	Number of 7004 records to be listed in each page. Note: PageSize can be maximum of 100.
EfileStatus	string	List the 7004 records based on the status ("CREATED, TRANSMITTED, ACCEPTED, REJECTED")
FromDate	string	Enter a date from which the Form 7004 records need to be listed in MM/DD/YYYY format.
ToDate	string	Enter a date till which the 7004 records created are to be listed in MM/DD/YYYY format.

Response Body

Field	Type	Description
Form7004Records	object	Pulls the Form 7004 records with Success and Error statuses
SubmissionId	string	Unique identifier of a submission.
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of a payer
BusinessNm	string	Returns name of the business
EIN	string	Returns the Employer Identification Number (EIN) of the Business
TaxYear	string	Tax year of 7004 filed.
ExtnFormCd	string	Form code of the return for which automatic business income or information return extension is requested
EFileStatus	string	Returns the record status.
TotalRecords	number	Total number of records.
TotalPages	number	Total number of pages.
Page	number	Pulls the records listed in the page selected
PageSize	number	Number of 7004 records to be listed in each page.
Errors	object[]	Shows detailed error information
Id	string	Returns the validation error id
Name	string	Name of the validation error
Message	string	Description of the validation error

Request Params

"Form7004/List?BusinessId=1abc3bc8-a3dc-499e-9e28-f25c0c458f32&PayerRef=Payer001&EIN=758473546&EfileStatus=CREATED&TaxYear=2025&Page=1&FromDate=01/02/2025&ToDate=01/10/2025"

Response JSON

Success Response - This is a sample response for successful API requests.

{
  "Form7004Records": [
    {
      "SubmissionId": "8808fbb1-8e4b-4eff-9dea-9c9086bde8bf",
      "BusinessId": "5b048fda-7f08-4e4c-8b45-68c28da13450",
      "PayerRef": "Pe123",
      "BusinessNm": "Snowdaze LLC",
      "EIN": "62-7369245",
      "TaxYear": "2025",
      "ExtnFormCd": "2",
      "EFileStatus": "CREATED"
    },
    {
      "SubmissionId": "c9979c87-19c7-4697-97fc-952c6f78c432",
      "BusinessId": "12ecdcd0-4f36-4e3d-bf37-2e8a13aee0d9",
      "PayerRef": "Pe1246453",
      "BusinessNm": "Snowdaze LLC",
      "EIN": "62-7369555",
      "TaxYear": "2025",
      "ExtnFormCd": "02",
      "EFileStatus": "CREATED"
    }
  ],
  "TotalRecords": 2,
  "TotalPages": 1,
  "Page": 1,
  "PageSize": 2,
  "Errors": null
}