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": "082bc7f3-1340-46dd-bd07-f342519bfd47",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "082bc7f3-1340-46dd-bd07-f342519bfd47",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "849df278-1848-43fb-9919-dcd7e07bd5f8",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "RetSeqId": null,
        "RecordId": "1f257899-494e-4cae-ae33-5015cf540954",
        "BusinessId": "505ce4d6-145b-44c1-8a82-6446523e75b5",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "1f257899-494e-4cae-ae33-5015cf540954",
        "BusinessId": "505ce4d6-145b-44c1-8a82-6446523e75b5",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          }
        ]
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "3cd52d78-0c3e-4ac2-9f21-49b475b6abe0",
        "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": "3cd52d78-0c3e-4ac2-9f21-49b475b6abe0",
        "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": "082bc7f3-1340-46dd-bd07-f342519bfd47",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "082bc7f3-1340-46dd-bd07-f342519bfd47",
              "VIN": null,
              "WeightCategory": "V",
              "IsLogging": true,
              "IsAgriculture": true,
              "VehicleTax": 0.0,
              "IsPrivatelyPurchased": false,
              "PurchasedMonth": null
            }
          ],
          "PriorYearSuspendedVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            },
            {
              "VehSeqId": null,
              "VehicleId": "808a9667-8ec3-4f36-8aa7-01bb61b47273",
              "VIN": null,
              "SuspendedType": "SOLDORTRANSFERRED",
              "SoldTo": "Wiliamson",
              "SoldDate": "09/29/2019"
            }
          ],
          "CreditVehicles": [
            {
              "VehSeqId": null,
              "VehicleId": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "aa2e4e43-4f85-4b27-9b27-b27d99f9ffa1",
              "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": "849df278-1848-43fb-9919-dcd7e07bd5f8",
  "Form2290Records": {
    "SuccessRecords": [
      {
        "RetSeqId": null,
        "RecordId": "1f257899-494e-4cae-ae33-5015cf540954",
        "BusinessId": "505ce4d6-145b-44c1-8a82-6446523e75b5",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          }
        ]
      },
      {
        "RetSeqId": null,
        "RecordId": "1f257899-494e-4cae-ae33-5015cf540954",
        "BusinessId": "505ce4d6-145b-44c1-8a82-6446523e75b5",
        "RecordStatus": null,
        "StatusTs": null,
        "ReportingVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "2add2dd7-0c2a-47e6-a212-2e425ca6b2fe",
            "TaxAmount": 2.0
          }
        ],
        "PriorYearSuspendedVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "f4ddafd9-a4a0-4bac-ad19-8b1f55d0bb1e"
          }
        ],
        "CreditVehicles": [
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          },
          {
            "VehSeqId": null,
            "VIN": null,
            "VehicleId": "8d6aaae0-52c5-4ac4-93ad-7d254619fade",
            "CreditAmount": 2.0
          }
        ]
      }
    ],
    "ErrorRecords": [
      {
        "RetSeqId": null,
        "RecordId": "3cd52d78-0c3e-4ac2-9f21-49b475b6abe0",
        "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": "3cd52d78-0c3e-4ac2-9f21-49b475b6abe0",
        "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"
    }
  ]
}