form2290

POST form2290/Update

This API method updates a Return with ExpressTruckTax. In response, businessId and returnId is updated which is further used as a reference for all other methods of the Returns API.

Request

Name Type Description Condition
SubmissionId globally unique identifier

Form2290Records Collection of Form2290UpdateRecords

Request Formats

application/json, text/json

Sample:
{
  "SubmissionId": "004d4ad4-3ab8-465a-b3e3-5729713d8335",
  "Form2290Records": [
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "RecordId": "b7152333-1019-4486-b06a-aa392ce1a543",
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": {
            "CreateVehicles": [
              null,
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "PriorYearSuspendedVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "CreditVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "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"
          }
        }
      }
    },
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "RecordId": "b7152333-1019-4486-b06a-aa392ce1a543",
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": {
            "CreateVehicles": [
              null,
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "PriorYearSuspendedVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "CreditVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "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"
          }
        }
      }
    }
  ]
}

Response

Name Type Description
StatusCode integer

StatusName string

StatusMessage string

SubmissionId globally unique identifier

Form2290Records Form2290UpdateResponseRecord

Errors Collection of Error

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": null,
  "StatusMessage": null,
  "SubmissionId": "203b82e1-dc1f-4fc6-bce3-a802d0e7e803",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "Sequence": null,
        "RecordId": "85762601-2e0d-41e0-a32c-0245a9e37124",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "PriorYearSuspendedVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "CreditVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        }
      },
      {
        "Sequence": null,
        "RecordId": "85762601-2e0d-41e0-a32c-0245a9e37124",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "PriorYearSuspendedVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "CreditVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        }
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "b1d9a5ed-6c30-42e4-b32b-d38b02f092e3",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "CreditVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "b1d9a5ed-6c30-42e4-b32b-d38b02f092e3",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "CreditVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ]
      }
    ]
  },
  "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

POST form2290/Update

This API method updates a Return with ExpressTruckTax. In response, businessId and returnId is updated which is further used as a reference for all other methods of the Returns API.

Request

Name Type Description Condition
SubmissionId globally unique identifier

Form2290Records Collection of Form2290UpdateRecords

Request Formats

application/json, text/json

Sample:
{
  "SubmissionId": "004d4ad4-3ab8-465a-b3e3-5729713d8335",
  "Form2290Records": [
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "RecordId": "b7152333-1019-4486-b06a-aa392ce1a543",
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": {
            "CreateVehicles": [
              null,
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "PriorYearSuspendedVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "CreditVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "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"
          }
        }
      }
    },
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "RecordId": "b7152333-1019-4486-b06a-aa392ce1a543",
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": {
            "CreateVehicles": [
              null,
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "dc85c2d8-428c-43a5-808b-8b8b301df7a6",
                "VIN": null,
                "WeightCategory": "V",
                "IsLogging": true,
                "IsAgriculture": true,
                "VehicleTax": 0.0,
                "IsPrivatelyPurchased": false,
                "PurchasedMonth": null
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "PriorYearSuspendedVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              },
              {
                "VehSeqId": null,
                "VehicleId": "7ac62f99-9c1d-41b4-9f27-e845e686b3a7",
                "VIN": null,
                "SuspendedType": "SOLDORTRANSFERRED",
                "SoldTo": "Wiliamson",
                "SoldDate": "09/29/2019"
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "CreditVehicles": {
            "CreateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "UpdateVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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": "6958168a-8c63-4198-b82c-c1b1f0d949e1",
                "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"
                }
              }
            ],
            "DeleteVehicles": [
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              },
              {
                "VehSeqId": null,
                "VehicleId": "4de221c3-ae45-4e92-80eb-4c8d6a930dea",
                "Status": null
              }
            ]
          },
          "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"
          }
        }
      }
    }
  ]
}

Response

Name Type Description
StatusCode integer

StatusName string

StatusMessage string

SubmissionId globally unique identifier

Form2290Records Form2290UpdateResponseRecord

Errors Collection of Error

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": null,
  "StatusMessage": null,
  "SubmissionId": "203b82e1-dc1f-4fc6-bce3-a802d0e7e803",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "Sequence": null,
        "RecordId": "85762601-2e0d-41e0-a32c-0245a9e37124",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "PriorYearSuspendedVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "CreditVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        }
      },
      {
        "Sequence": null,
        "RecordId": "85762601-2e0d-41e0-a32c-0245a9e37124",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "b407fde0-d961-4bc9-b2eb-9113e8c9184d",
              "TaxAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "PriorYearSuspendedVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "1c5daf64-cc17-41ba-9753-1c2b3584584e"
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        },
        "CreditVehicles": {
          "CreateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "UpdateVehicles": [
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            },
            {
              "VehSeqId": null,
              "VIN": null,
              "VehicleId": "789ca5e0-83b7-4c6f-8a7b-ef64114262a7",
              "CreditAmount": 2.0
            }
          ],
          "DeleteVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            },
            {
              "VehSeqId": null,
              "VehicleId": "b5d8f0a3-74da-477e-87d5-2bc3e75f5f72",
              "Status": null
            }
          ]
        }
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "b1d9a5ed-6c30-42e4-b32b-d38b02f092e3",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "CreditVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "b1d9a5ed-6c30-42e4-b32b-d38b02f092e3",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ],
        "CreditVehicles": [
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          },
          {
            "Errors": [
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              },
              {
                "VehSeqId": "1",
                "Code": "404",
                "Name": "NotFound",
                "UserMessage": "Record not found",
                "APIMessage": "Record not found",
                "Type": "Error"
              }
            ]
          }
        ]
      }
    ]
  },
  "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"
    }
  ]
}