form2290

GET form2290/Get

Request (URI)

Name Type Description Condition
SubmissionId globally unique identifier

Required

Response

Name Type Description
SubmissionId globally unique identifier

Form2290Records Collection of Form2290Response

A detailed information about the Business, Employees and Form 941 records

Errors Collection of Error

It will show the detailed information about the error.

StatusCode integer

It will return the status codes like 200, 300, etc., Refer Status Codes.

StatusName string

It will return the name of status code.

StatusMessage string

It will return the detailed message of status code.

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "ec9b1a89-d184-4939-870e-df932525f50d",
  "Form2290Records": [
    {
      "RecordId": "f101a86b-ab84-4181-a4ba-35a3b2b83b56",
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "c7330eee-04e9-405d-a916-b7b1da3eb36f",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            },
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            }
          ],
          "IRSPaymentType": null,
          "IRSPayments": {
            "BankRoutingNum": "147258963",
            "AccountType": "Checking",
            "BankAccountNum": "1234567893692",
            "Phone": "9176394319"
          },
          "ConsentToDisclosure": {
            "IsConsentToDisclose": true,
            "ConsentPin": "26153"
          },
          "IsThirdPartyDesignee": true,
          "ThirdPartyDesigneeDetails": {
            "Name": "joe",
            "Phone": "9962104274",
            "DesigneePIN": "12456"
          },
          "Signature": {
            "SignatureType": "TaxPayerPIN",
            "TaxPayerPIN": "78945"
          }
        }
      }
    },
    {
      "RecordId": "f101a86b-ab84-4181-a4ba-35a3b2b83b56",
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "c7330eee-04e9-405d-a916-b7b1da3eb36f",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            },
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            }
          ],
          "IRSPaymentType": null,
          "IRSPayments": {
            "BankRoutingNum": "147258963",
            "AccountType": "Checking",
            "BankAccountNum": "1234567893692",
            "Phone": "9176394319"
          },
          "ConsentToDisclosure": {
            "IsConsentToDisclose": true,
            "ConsentPin": "26153"
          },
          "IsThirdPartyDesignee": true,
          "ThirdPartyDesigneeDetails": {
            "Name": "joe",
            "Phone": "9962104274",
            "DesigneePIN": "12456"
          },
          "Signature": {
            "SignatureType": "TaxPayerPIN",
            "TaxPayerPIN": "78945"
          }
        }
      }
    }
  ],
  "Errors": [
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    },
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    }
  ]
}

form2290

GET form2290/Get

Request (URI)

Name Type Description Condition
SubmissionId globally unique identifier

Required

Response

Name Type Description
SubmissionId globally unique identifier

Form2290Records Collection of Form2290Response

A detailed information about the Business, Employees and Form 941 records

Errors Collection of Error

It will show the detailed information about the error.

StatusCode integer

It will return the status codes like 200, 300, etc., Refer Status Codes.

StatusName string

It will return the name of status code.

StatusMessage string

It will return the detailed message of status code.

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "ec9b1a89-d184-4939-870e-df932525f50d",
  "Form2290Records": [
    {
      "RecordId": "f101a86b-ab84-4181-a4ba-35a3b2b83b56",
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "c7330eee-04e9-405d-a916-b7b1da3eb36f",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            },
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            }
          ],
          "IRSPaymentType": null,
          "IRSPayments": {
            "BankRoutingNum": "147258963",
            "AccountType": "Checking",
            "BankAccountNum": "1234567893692",
            "Phone": "9176394319"
          },
          "ConsentToDisclosure": {
            "IsConsentToDisclose": true,
            "ConsentPin": "26153"
          },
          "IsThirdPartyDesignee": true,
          "ThirdPartyDesigneeDetails": {
            "Name": "joe",
            "Phone": "9962104274",
            "DesigneePIN": "12456"
          },
          "Signature": {
            "SignatureType": "TaxPayerPIN",
            "TaxPayerPIN": "78945"
          }
        }
      }
    },
    {
      "RecordId": "f101a86b-ab84-4181-a4ba-35a3b2b83b56",
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "c7330eee-04e9-405d-a916-b7b1da3eb36f",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6bdc1bc2-8037-4dab-aefa-6cb44bc8b136",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            },
            {
              "VehSeqId": null,
              "VehicleId": "c0423723-80bf-4574-8194-0c0ea75b0bd1",
              "VIN": null,
              "CreditType": "SOLD",
              "PrevFiledTaxYear": "2019",
              "PrevFiledFUM": "072019",
              "PrevFiledGW": "F",
              "IsLogging": true,
              "IRSExplaination": "Vehicle has been sold",
              "CreditAmount": 3.0,
              "SoldDetails": {
                "SoldDate": "12/12/2019",
                "SoldTo": "George",
                "IsForeign": true,
                "USAddress": {
                  "Address": "12 main st",
                  "City": "Denver",
                  "State": "CO",
                  "ZipCode": "80011"
                },
                "ForeignAddress": {
                  "Address": "857  th Avenue",
                  "City": "Whitecourt",
                  "ProvinceOrStateNm": "Alberta",
                  "Country": "CA",
                  "PostalCd": "T7S 1A1"
                },
                "Email": "george@gmail.com",
                "Phone": "9176394319"
              },
              "DestroyedDetails": {
                "DestroyedDate": "12/12/2019"
              },
              "StolenDetails": {
                "StolenDate": "12/12/2019"
              }
            }
          ],
          "IRSPaymentType": null,
          "IRSPayments": {
            "BankRoutingNum": "147258963",
            "AccountType": "Checking",
            "BankAccountNum": "1234567893692",
            "Phone": "9176394319"
          },
          "ConsentToDisclosure": {
            "IsConsentToDisclose": true,
            "ConsentPin": "26153"
          },
          "IsThirdPartyDesignee": true,
          "ThirdPartyDesigneeDetails": {
            "Name": "joe",
            "Phone": "9962104274",
            "DesigneePIN": "12456"
          },
          "Signature": {
            "SignatureType": "TaxPayerPIN",
            "TaxPayerPIN": "78945"
          }
        }
      }
    }
  ],
  "Errors": [
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    },
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    }
  ]
}