- Use Cases
- Use Case 9: Import Tax Forms
Use Cases
Use Case 9: Import Tax Forms
Import tax forms for taxpayers and list tax form parsing requests.
Import tax forms associated with taxpayers. Upload tax form data and associate it with an existing taxpayer using the taxpayerId.

Understanding Tax Forms
Tax forms represent various tax documents (e.g., 1040, 1120) associated with a taxpayer. Once imported, Remitian extracts relevant data from the form to create all necessary tax entities, tax accounts, and tax payments. The tax payments will be in Pending Approval status until approved. A bank account must be associated before payments can be processed.
File Requirements:
- Maximum file size: 10 MB
- Accepted formats: PDF
Available Tax Form Types:
US_1040- Individual Income Tax ReturnUS_1040ES- Estimated Tax for IndividualsUS_1065- Partnership Return of IncomeUS_1120- Corporation Income Tax ReturnUS_1120W- Estimated Tax for CorporationsUS_GA_500- Georgia Individual Income Tax ReturnUS_GA_500ES- Georgia Estimated TaxUS_CA_100- California Corporation Franchise or Income Tax ReturnUS_CA_100S- California S Corporation Franchise or Income Tax ReturnUS_CA_100ES- California Corporation Estimated TaxUS_CA_540ES- California Estimated Tax for Individuals
Available Tax Form Statuses:
Processing- Initial status after uploadInReview- Form type identified, extracted data is being reviewedError- Error processing the formCancelled- Import was cancelledCompleted- Form successfully processed, all entities/payments created
Import a Tax Form
Sequence of Events:
- Your system sends a request to import a tax form by uploading the form data and associating it with an existing taxpayer
- Remitian responds with the imported tax form’s details
HTTP Request:
POST https://public-api.remitian.com/v1/taxpayers/{taxpayerId}/tax-form-parsing-requests
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxxkTrZu0gW
Authorization: Bearer YOUR_ACCESS_TOKEN
x-api-key: YOUR_API_KEY
------WebKitFormBoundary7MA4YWxxkTrZu0gW
Content-Disposition: form-data; name="taxForm"; filename="tax_form.pdf"
%PDF-1.4
%... (binary content of the PDF file)
------WebKitFormBoundary7MA4YWxxkTrZu0gW--
HTTP Response:
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "079bc3f4-d65e-73f7-8133-f5800e825515",
"status": "Processing"
}
List Tax Form Parsing Requests
Sequence of Events:
- Your system sends a request to list all tax form parsing requests associated with a specific taxpayer
- Remitian responds with a paginated list of tax form parsing requests
HTTP Request:
GET https://public-api.remitian.com/v1/taxpayers/{taxpayerId}/tax-form-parsing-requests
Authorization: Bearer YOUR_ACCESS_TOKEN
x-api-key: YOUR_API_KEY
HTTP Response:
HTTP/1.1 200 OK
Content-Type: application/json
{
"items": [
{
"id": "079bc3f4-d65e-73f7-8133-f5800e825515",
"taxFormType": "US_1040",
"status": "Processing",
"fileName": "US_1040_tax_return_2023.pdf",
"sourceFileName": "tax_return_2023.pdf",
"creationTime": "2026-01-19T04:20:31.445Z"
}
],
"currentPage": 1,
"pageSize": 10,
"totalCount": 1,
"totalPages": 1
}