Status
GET Form5498ESA/Status
Request Params
Field | Type | Description |
---|---|---|
SubmissionId | Guid | Unique identifier of a submission. |
RecordIds | Guid | Number of record Ids to get status. |
Request Params
- Sample 1
- Sample 2
Get status with only the SubmissionID
Form5498ESA/Status?SubmissionId=a1fd86fb-e404-442d-ae37-c5f6d1a1cc14&RecordIds=2d9309cd-5b5b-42bf-b68a-c237c9b2c67e
Get status with SubmissionID and 2 RecordIDs
Form5498ESA/Status?SubmissionId=b8b7d0ad-51e2-424a-bc46-8425de87f7c7&RecordIds=b230f379-74fb-4c00-8d9e-948733ff5c12,def3591c-7c66-4d15-a8b1-c36f22e90150
Response Body
Field | Type | Description |
---|---|---|
StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
StatusName | string | Name of the status code |
StatusMessage | string | Detailed status message |
SubmissionId | Guid | Unique identifier of a submission |
BusinessId | Guid | Unique identifier of a Business. |
PayerRef | string | Unique identifier of the payer. |
Form5498ESAType | string | Denotes the type of 5498 ESA form. |
Form5498ESARecords | object | Pulls Form 5498 ESA records with Success and Error statuses |
SuccessRecords | object[] | It will show detailed information about the success status of Form 5498 ESA Records |
SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
RecordId | Guid | An unique identifier generated by TaxBandits when a 5498 ESA return is created. |
RecipientId | Guid | An unique identifier generated by TaxBandits for a Recipient when a 5498 ESA return is created. You can use this id for your future reference to update. |
PayeeRef | string | A unique identifier for each payee completing their information. |
AccountNum | string | Account number of Payer having multiple accounts for a recipient for whom more than one Form 1099-NEC is filed. Size Range: 4..20 Note: If the account number on the return you file is the same as any previously filed return, TaxBandits will append 3 random numbers at the end of the account number. |
FederalReturn | object | Returns the record status and StatusTs of federal return. |
Status | string | Returns the record status. |
StatusTs | string | Returns date and time of return created. |
Info | string | Returns information about the Federal Filing service. |
Errors | object[] | Shows error information in state returns of Form 5498 ESA |
Postal | object | Returns the status and StatusTs of postal mailing service for Form 5498 ESA . |
Status | string | Returns the status of postal order. |
StatusTs | string | Returns the date and time of the postal order created. |
Info | string | Returns the information about Postal mailing service. |
OnlineAccess | object | Returns the Email address for whom the online access to be given and Status of online access. |
Status | string | Returns status of online access for Form 5498 ESA return. |
string | Email address for whom the online access to be given. | |
Info | string | Information about the online access service. |
ScheduleFiling | object | Returns the date of the schedule filing. |
ScheduledOn | string | Date of the schedule filing to know when the return to be filed to the IRS. |
Info | string | Information about Schedule Filing service. |
ErrorRecords | object[] | It will show the detailed information about the error status of Form 5498 ESA Records. |
SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
RecordId | Guid | Unique identifier of a record. |
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. |
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. |
Response JSON
- 200
- 300
- 404
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "a1fd86fb-e404-442d-ae37-c5f6d1a1cc14",
"BusinessId": "e097c642-f1cf-48b0-88fc-01c1197647c3",
"PayerRef": "Snow123",
"Form5498Type": "5498ESA",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "2d9309cd-5b5b-42bf-b68a-c237c9b2c67e",
"RecipientId": "1325f550-cc2b-484a-8173-83ffb805e6cf",
"PayeeRef": "Payee001",
"AccountNum": "20241520058563079953",
"FederalReturn": {
"Status": "TRANSMITTED",
"StatusTs": "2024-06-05 06:54:28 -04:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2024-06-05 06:54:28 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "EMAIL_SENT",
"Email": "shawn@sample.com",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": null,
"Info": "This service will be available soon"
}
},
{
"SequenceId": "2",
"RecordId": "bd312551-60fe-4775-a8e3-a48acc96899b",
"RecipientId": "1325f550-cc2b-484a-8173-83ffb805e6cf",
"PayeeRef": "Payee002",
"AccountNum": "20248765438563079953",
"FederalReturn": {
"Status": "SENT TO AGENCY",
"StatusTs": "2024-06-05 06:55:08 -04:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2024-06-05 06:56:04 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "EMAIL_SENT",
"Email": "shawn@sample.com",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": null,
"Info": "This service will be available soon"
}
},
{
"SequenceId": "3",
"RecordId": "a051a093-2d40-4bdd-80a7-c102b489da38",
"RecipientId": "1325f550-cc2b-484a-8173-83ffb805e6cf",
"PayeeRef": "Payee003",
"AccountNum": "20241520058563098543",
"FederalReturn": {
"Status": "ACCEPTED",
"StatusTs": "2024-06-05 06:55:16 -04:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2024-06-05 06:56:13 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "EMAIL_SENT",
"Email": "shawn@sample.com",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": null,
"Info": "This service will be available soon"
}
},
{
"SequenceId": "4",
"RecordId": "124355cd-b7ed-4103-8214-1b7f78980f74",
"RecipientId": "1325f550-cc2b-484a-8173-83ffb805e6cf",
"PayeeRef": "Payee004",
"AccountNum": "2024152005856654213",
"FederalReturn": {
"Status": "REJECTED",
"StatusTs": "2024-06-05 06:55:16 -04:00",
"Info": null,
"Errors": [
{
"Id": "F68-FED-10001",
"Name": "Rejected Record",
"Message": "Sample Error Message"
}
]
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2024-06-05 06:56:13 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "EMAIL_SENT",
"Email": "shawn@sample.com",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": null,
"Info": "This service will be available soon"
}
}
],
"ErrorRecords": null
},
"Errors": null
}
Multi-status Response - You'll get the below response when multiple statuses are included.
{
"StatusCode": 300,
"StatusName": "MultiStatus",
"StatusMessage": "Multiple statuses are available for the request",
"SubmissionId": "3d8778f5-fd55-4d0b-94ff-327bd10e0b4b",
"BusinessId": "dd5480a8-92ed-4353-a893-f9187f7122ae",
"PayerRef": "Snow123",
"Form5498Type": "5498ESA",
"Form5498ESARecords": {
"SuccessRecords": [
{
"SequenceId": "01",
"RecordId": "1310081c-c887-4619-8eb0-0a6612056de5",
"RecipientId": "2a208545-6651-4ffd-b1c8-e871b7e6dc3b",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2024-07-01 06:45:05 -04:00",
"Info": null,
"Errors": null
},
"Postal": null,
"OnlineAccess": {
"Status": "CREATED",
"Email": "dairy@sample.com",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": null,
"Info": "This service will be available soon"
}
}
],
"ErrorRecords": [
{
"SequenceId": null,
"RecordId": "faede428-33fd-4966-b4b4-817f228a2985",
"Errors": [
{
"Id": "F00-100192",
"Name": "RecordId",
"Message": "Invalid RecordId"
}
]
}
]
},
"Errors": [
{
"Id": "F00-100155",
"Name": "Error Records",
"Message": "Some of the records are errored. Please read the Error Records for more details."
}
]
}
Not Found Response - You'll get the below response if your API request contains a record that's not found in our database.
{
"StatusCode": 404,
"StatusName": "NotFound",
"StatusMessage": "The resource you have specified cannot be found",
"SubmissionId": "3d8778f5-fd55-4d0b-94ff-327bd10e0b4b",
"BusinessId": null,
"PayerRef": null,
"Form5498Type": "5498ESA",
"Form5498ESARecords": {
"SuccessRecords": null,
"ErrorRecords": [
{
"SequenceId": null,
"RecordId": "faede428-33fd-4966-b4b4-817f228a2985",
"Errors": [
{
"Id": "F00-100192",
"Name": "RecordId",
"Message": "Invalid RecordId"
}
]
}
]
},
"Errors": null
}