form2290

GET form2290/Status

Request (URI)

Name Type Description Condition
SubmissionId globally unique identifier

Required

RecordIds string

Required

EIN string

Required

TaxYear string

Required

Response

Name Type Description
SubmissionId globally unique identifier

Submission ID

Form2290StatusRecords Form2290StatusRecords

Form 2290 records success and error status

Errors Collection of Error

It will show the detailed information about the error.

StatusCode integer

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

StatusName string

It will return the name of status code.

StatusMessage string

It will return the detailed message of status code.

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "925dd357-829d-4be3-a784-e992db105d3a",
  "Form2290StatusRecords": {
    "SuccessRecords": [
      {
        "Sequence": null,
        "RecordId": "561bebe6-85ea-46d9-be82-6a2560c72cab",
        "RecordStatus": null,
        "StatusTs": "2020-06-10 12:05:05 +05:30"
      },
      {
        "Sequence": null,
        "RecordId": "561bebe6-85ea-46d9-be82-6a2560c72cab",
        "RecordStatus": null,
        "StatusTs": "2020-06-10 12:05:05 +05:30"
      }
    ],
    "ErrorRecords": [
      {
        "RecordId": "ada8c9df-6e14-4b06-8fee-19f32537a6e6",
        "Sequence": null,
        "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"
          }
        ]
      },
      {
        "RecordId": "ada8c9df-6e14-4b06-8fee-19f32537a6e6",
        "Sequence": null,
        "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"
          }
        ]
      }
    ]
  },
  "Errors": [
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    },
    {
      "Code": "404",
      "SeqId": "1",
      "Name": "NotFound",
      "UserMessage": "Record not found",
      "APIMessage": "Record not found",
      "Type": "Error"
    }
  ]
}

form2290

GET form2290/Status

Request (URI)

Name Type Description Condition
SubmissionId globally unique identifier

Required

RecordIds string

Required

EIN string

Required

TaxYear string

Required

Response

Name Type Description
SubmissionId globally unique identifier

Submission ID

Form2290StatusRecords Form2290StatusRecords

Form 2290 records success and error status

Errors Collection of Error

It will show the detailed information about the error.

StatusCode integer

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

StatusName string

It will return the name of status code.

StatusMessage string

It will return the detailed message of status code.

Response Formats

application/json, text/json

Sample:
{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "925dd357-829d-4be3-a784-e992db105d3a",
  "Form2290StatusRecords": {
    "SuccessRecords": [
      {
        "Sequence": null,
        "RecordId": "561bebe6-85ea-46d9-be82-6a2560c72cab",
        "RecordStatus": null,
        "StatusTs": "2020-06-10 12:05:05 +05:30"
      },
      {
        "Sequence": null,
        "RecordId": "561bebe6-85ea-46d9-be82-6a2560c72cab",
        "RecordStatus": null,
        "StatusTs": "2020-06-10 12:05:05 +05:30"
      }
    ],
    "ErrorRecords": [
      {
        "RecordId": "ada8c9df-6e14-4b06-8fee-19f32537a6e6",
        "Sequence": null,
        "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"
          }
        ]
      },
      {
        "RecordId": "ada8c9df-6e14-4b06-8fee-19f32537a6e6",
        "Sequence": null,
        "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"
          }
        ]
      }
    ]
  },
  "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"
    }
  ]
}