form2290

POST form2290/create

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

Request

Name Type Description Condition
Form2290Records Collection of Form2290Records

Request Formats

application/json, text/json

Sample:
{
  "Form2290Records": [
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "e0d3a5d6-e334-470b-8a9d-eb5b98488753",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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"
          }
        }
      }
    },
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "e0d3a5d6-e334-470b-8a9d-eb5b98488753",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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"
          }
        }
      }
    }
  ]
}

Response

Name Type Description
StatusCode integer

StatusName string

StatusMessage string

SubmissionId globally unique identifier

Form2290Records Form2290ResponseRecords

Errors Collection of Error

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": null,
  "StatusMessage": null,
  "SubmissionId": "bebf101f-c299-4657-a96c-cabe3a780848",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "RetSeqId": null,
        "RecordId": "7f8ffbc6-4285-442b-9e26-776b228fba3c",
        "BusinessId": "78e021b2-c686-45e4-ba76-eabc0522b830",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "7f8ffbc6-4285-442b-9e26-776b228fba3c",
        "BusinessId": "78e021b2-c686-45e4-ba76-eabc0522b830",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          }
        ]
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "9de3f72d-99d9-46ba-bd0f-1bd4ca623b00",
        "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": "9de3f72d-99d9-46ba-bd0f-1bd4ca623b00",
        "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/create

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

Request

Name Type Description Condition
Form2290Records Collection of Form2290Records

Request Formats

application/json, text/json

Sample:
{
  "Form2290Records": [
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "e0d3a5d6-e334-470b-8a9d-eb5b98488753",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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"
          }
        }
      }
    },
    {
      "RetSeqId": null,
      "ReturnHeader": {
        "BusinessDetails": null
      },
      "ReturnData": {
        "Form2290": {
          "IsFinalReturn": true,
          "IsAddressChange": true,
          "FUM": "072019",
          "TotalTax": null,
          "Credits": null,
          "BalanceDue": null,
          "ReportingVehicles": [
            null,
            {
              "VehSeqId": null,
              "VehicleId": "e0d3a5d6-e334-470b-8a9d-eb5b98488753",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "6d3afca8-d0e5-44c4-bd54-04df40eae9d2",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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": "60c459bf-4d7e-4360-99ea-f1b28ebdd47e",
              "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"
          }
        }
      }
    }
  ]
}

Response

Name Type Description
StatusCode integer

StatusName string

StatusMessage string

SubmissionId globally unique identifier

Form2290Records Form2290ResponseRecords

Errors Collection of Error

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": null,
  "StatusMessage": null,
  "SubmissionId": "bebf101f-c299-4657-a96c-cabe3a780848",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "RetSeqId": null,
        "RecordId": "7f8ffbc6-4285-442b-9e26-776b228fba3c",
        "BusinessId": "78e021b2-c686-45e4-ba76-eabc0522b830",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "7f8ffbc6-4285-442b-9e26-776b228fba3c",
        "BusinessId": "78e021b2-c686-45e4-ba76-eabc0522b830",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "6a4c4b76-09a3-4aab-819a-fb7a14d37e59",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "695c7da0-a53f-4394-ba8c-00a1d6cf0f66"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "a76e0674-cfb2-4d61-be3d-5c6c08cb5d8d",
            "CreditAmount": 2.0
          }
        ]
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "9de3f72d-99d9-46ba-bd0f-1bd4ca623b00",
        "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": "9de3f72d-99d9-46ba-bd0f-1bd4ca623b00",
        "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"
    }
  ]
}