1. Use Cases
  2. Use Case 9: Import Tax Forms

Import tax forms associated with taxpayers. Upload tax form data and associate it with an existing taxpayer using the taxpayerId.

Use Case 9: Import Tax Forms

​
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 Return
  • US_1040ES - Estimated Tax for Individuals
  • US_1065 - Partnership Return of Income
  • US_1120 - Corporation Income Tax Return
  • US_1120W - Estimated Tax for Corporations
  • US_GA_500 - Georgia Individual Income Tax Return
  • US_GA_500ES - Georgia Estimated Tax
  • US_CA_100 - California Corporation Franchise or Income Tax Return
  • US_CA_100S - California S Corporation Franchise or Income Tax Return
  • US_CA_100ES - California Corporation Estimated Tax
  • US_CA_540ES - California Estimated Tax for Individuals

Available Tax Form Statuses:

  • Processing - Initial status after upload
  • InReview - Form type identified, extracted data is being reviewed
  • Error - Error processing the form
  • Cancelled - Import was cancelled
  • Completed - Form successfully processed, all entities/payments created

​
Import a Tax Form

Sequence of Events:

  1. Your system sends a request to import a tax form by uploading the form data and associating it with an existing taxpayer
  2. 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:

  1. Your system sends a request to list all tax form parsing requests associated with a specific taxpayer
  2. 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
}