Approve
Approve
This endpoint will be applicable only if you’ve generated 1099-MISC forms using the ‘GenerateFromTxns’ method.
Once TaxBandits generates the draft 1099-MISC forms, you can use this endpoint to approve them. Once approved, you will be able to transmit the forms using the Transmit endpoint.
POST Form1099MISC/Approve Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| RecordIds | Guid[] | List of record Ids to get the Approved Form 1099-MISC. |
Response Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission. |
| Form1099MISCRecords | object | Contains Form 1099MISC records that are approved. |
| SuccessRecords | object[] | Contains detailed information of Form 1099 MISCs that were successfully approved. |
| RecordId | string | Unique identifier of a record |
| Status | Guid | Status of the 1099-MISC. |
| StatusTs | Guid | Returns date and time of return created. |
| ErrorRecords | object[] | Contains the list of errors |
| PayeeRef | string | Unique identifier of the recipient. Set by the client. |
| RecipientId | Guid | Unique identifier of the recipient. Generated by TaxBandits. |
| Errors | object[] | Shows detailed error information |
| Id | string | Returns the validation error Id |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
| Errors | object[] | Shows the detailed error information |
| Id | string | Validation error Id |
| Name | string | Name of the validation error |
| Message | string | Description of the validation error |
Request JSON
{
"SubmissionId": "494f2e25-c1b7-490f-814a-65b573c9d342",
"RecordIds": [
"80d90736-2c6b-43a4-8561-7c66a090ed5f"
]
}
Response JSON
Success Response - This is a sample response for successful API requests.
{
"SubmissionId": "494f2e25-c1b7-490f-814a-65b573c9d342",
"Form1099MISCRecords": {
"SuccessRecords": [
{
"RecordId": "80d90736-2c6b-43a4-8561-7c66a090ed5f",
"Status": "CREATED",
"StatusTs": "2025-10-28 09:24:43 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}