PostalTracking

PostalTracking

This utility allows you to get the detailed postal mailing status of the submitted returns. Which can be used for your reference.

In the request, provide a specific SubmissionId, BusinessId, and Tax Year to retrieve the status of that submission.

GET Utility/PostalTracking  

Run in Postman

Request Params

Field	Type	Description
BusinessId	Guid	A unique identifier of a business
TaxYear	string	List the postal record status based on the given tax year. Allowed values "2023", "2024", "2025"
SubmissionId	Guid	A unique identifier of a submission
RecordId	Guid	A unique identifier of a record
Page	number	Pulls the records listed on the page selected
PageSize	number	Number of 1099-NEC records to be listed on each page. Note: PageSize can be a maximum of 100
FromDate	string	Enter a date from which the Form 1099-NEC records need to be listed in MM/DD/YYYY format
ToDate	string	Enter a date till which the 1099-NEC records created are to be listed in MM/DD/YYYY format

Response Body

Field	Type	Description
TaxYear	string	Tax year for which the return is created Allowed values "2023", "2024", "2025"
Business	object	It will show the detailed information about the business
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of the Payer
BusinessNm	string	Name of the business
FirstNm	string	First Name of the Individual
MiddleNm	string	Middle Name of the Individual
LastNm	string	Last Name of the Individual
Suffix	string	Suffix of the Individual
PostalMailingRecords	object[]	It will show the detailed information about the status of the postal mailing
SubmissionId	Guid	Unique identifier of a submission
RecordId	Guid	Unique identifier of a record
PayeeRef	string	A unique identifier for each payee, completing their information
FormType	string	Returns the type of form
Recipient	object[]	Object to identify the recipient details
RecipientId	Guid	A unique identifier generated by TaxBandits for a Recipient
PayeeRef	string	A unique identifier for each payee completing their information
FirstPayeeNm	string	Returns the name of the recipient
SecondPayeeNm	string	Returns the name of the second recipient
FirstNm	string	First Name of the Individual
MiddleNm	string	Middle Name of the Individual
LastNm	string	Last Name of the Individual
Suffix	string	Suffix of the Individual
IsForeign	boolean	When true, identifies the recipient address with a foreign address
USAddress	object	If IsForeign is false, pass the US address of the recipient
Address1	string	Recipient's US address
Address2	string	Recipient's suite or apartment
City	string	Recipient's city
State	string	Recipient's state code
ZipCd	string	Recipient's zip code
ForeignAddress	object	If IsForeign is true, pass the foreign address of the recipient
Address1	string	Recipient's foreign address
Address2	string	Recipient's suite or apartment
City	string	Recipient's city
ProvinceOrStateNm	string	Recipient's Province or State Name
Country	string	Recipient's country code
PostalCd	string	Recipient's Postal Code
Fax	string	Recipient's Fax number
Phone	string	Recipient's Phone Number
TrackingStatusDetails	object[]	It will show the detailed information about the Tracking status of the postal mailing
Status	string	Returns the tracking status of postal mail
StatusTs	string	Returns the date and time of the postal mail tracking status
TrackingLocation	string	Returns the location of the postal mail tracking
TrackingInfo	string	Returns the information about the postal mail tracking
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 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

"Utility/PostalTracking?BusinessId=b1c21945-26b0-4dda-af2c-8288344e207e&TaxYear=2025&SubmissionId=59a736e5-1ded-4859-8fbb-0a9a592051a5&RecordId=59a736e5-1ded-4859-8fbb-0a9a592051a5&Page=1&PageSize=10&FromDate=08/01/2024&ToDate=08/02/2024"

Response JSON

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

{
  "TaxYear": "2025",
  "Business": {
    "BusinessId": "519a84f4-5e56-496a-82f3-18f51fdf3d75",
    "PayerRef": "Snow123",
    "BusinessNm": "Snowdaze LLC",
    "FirstNm": null,
    "MiddleNm": null,
    "LastNm": null,
    "Suffix": null
  },
  "PostalMailingRecords": [
    {
      "SubmissionId": "c61f5fa0-67d6-4096-a175-6a9eb0f0c67e",
      "RecordId": "e9f39bd7-76f7-4805-a3a9-e7eeed494d3a",      
      "FormType": "Form1099NEC",
      "Recipient": {
        "RecipientId": "4193c997-9ce6-41b6-87f6-049d4f39444d",
        "PayeeRef": "PayeeRef01",
        "FirstPayeeNm": "Dairy Delight LLC",
        "SecondPayeeNm": null,
        "FirstNm": null,
        "LastNm": null,
        "MiddleNm": null,
        "Suffix": null,
        "IsForeign": false,
        "USAddress": {
          "Address1": "2603 Kinsey Road",
          "Address2": "Main Street",
          "City": "Dothan",
          "State": "AL",
          "ZipCd": "36303"
        },
        "ForeignAddress": null,
        "Fax": null,
        "Phone": null
      },
      "TrackingStatusDetails": [
        {
          "Status": "ORDER_RECEIVED",
          "StatusTs": "01/13/2026 10:18:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "POSTAL_INITIATED",
          "StatusTs": " 01/13/2026 10:17:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "HANDED_OVER_TO_USPS",
          "StatusTs": "01/13/2026 10:16:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "IN_TRANSIT",
          "StatusTs": " 01/13/2026 10:17:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "IN_TRANSIT",
          "StatusTs": " 01/13/2026 10:17:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "OUT_FOR_DELIVERY",
          "StatusTs": "01/13/2026 10:15:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        },
        {
          "Status": "ASSUMED_DELIVERED",
          "StatusTs": "01/13/2026 10:14:45",
          "TrackingLocation": null,
          "TrackingInfo": null
        }
      ]
    }
  ],
  "Page": 1,
  "TotalRecords": 1,
  "TotalPages": 1,
  "PageSize": 100,
  "Errors": null
}