- Use Cases
- Use Case 5: Manage Tax Accounts
Use Cases
Use Case 5: Manage Tax Accounts
Create and list tax accounts for tax entities across supported tax authorities.
Manage tax accounts associated with tax entities. Create and list tax accounts using your system’s tax account ID with the externalId field. Each tax account must be associated with an existing tax entity.

Understanding Tax Accounts
Tax accounts represent specific tax obligations (e.g., federal, state) for a tax entity. For one tax entity, you can create multiple tax accounts for different tax authorities. Once created, you can schedule tax payments for them.
Available Tax Account Types:
PersonalCorporate
Available Tax Authorities:
US_IRS- Internal Revenue ServiceUS_GA- Georgia Department of RevenueUS_CA- California Franchise Tax BoardUS_DC- District of Columbia Office of Tax and RevenueUS_WI- Wisconsin Department of RevenueUS_CO- Colorado Department of RevenueUS_AZ- Arizona Department of RevenueUS_MA- Massachusetts Department of RevenueUS_NC- North Carolina Department of RevenueUS_VA- Virginia Department of TaxationUS_NJ- New Jersey Division of TaxationUS_FL- Florida Department of RevenueUS_IL- Illinois Department of RevenueUS_PA- Pennsylvania Department of RevenueUS_MD- Comptroller of MarylandUS_TX- Texas Comptroller of Public AccountsUS_OH- Ohio Department of TaxationUS_SC- South Carolina Department of RevenueUS_DE- Delaware Division of RevenueUS_UT- Utah State Tax CommissionUS_VT- Vermont Department of TaxesUS_KY- Kentucky Department of RevenueUS_MI- Michigan Department of TreasuryUS_MO- Missouri Department of RevenueUS_OK- Oklahoma Tax CommissionUS_NM- New Mexico Taxation and Revenue DepartmentUS_OR- Oregon Department of RevenueUS_PA_PHI- Philadelphia Department of RevenueUS_TN- Tennessee Department of RevenueUS_AR- Arkansas Department of Finance and AdministrationUS_ID- Idaho State Tax CommissionUS_IN- Indiana Department of RevenueUS_AL- Alabama Department of RevenueUS_HI- Hawaii Department of TaxationUS_KS- Kansas Department of RevenueUS_CT- Connecticut Department of Revenue ServicesUS_ND- North Dakota Office of State Tax CommissionerUS_LA- Louisiana Department of RevenueUS_ME- Maine Revenue ServicesUS_IA- Iowa Department of RevenueUS_MN- Minnesota Department of RevenueUS_WV- West Virginia Tax DivisionUS_NY- New York State Department of Taxation and FinanceUS_NYC- New York City Department of FinanceUS_MS- Mississippi Department of RevenueUS_MT- Montana Department of RevenueUS_NE- Nebraska Department of Revenue
Tax Account Object Structure:
| Field | Type | Description |
|---|---|---|
id | guid | Unique identifier for the tax account Example: 059bc3f4-d65e-73f7-8133-f5800e825513 |
externalId | string | Your system’s unique identifier Example: my_tax_account_123 |
taxEntityId | guid | Associated tax entity identifier Example: 039bc3f4-d65e-73f7-8133-f5800e825511 |
type | string | Type of the tax account Example: Personal, Corporate |
taxAuthority | string | Tax authority Example: US_IRS, US_GA |
externalId must be 3 to 100 characters long and contain only letters, numbers, spaces, underscores, commas, periods or hyphens.
Create a Tax Account
Sequence of Events:
- Your system sends a request to create a tax account using an external ID and associates it with an existing tax entity
- Remitian responds with the created tax account’s details
- Your system can then use this
idfor subsequent operations
HTTP Request:
POST https://public-api.remitian.com/v1/taxpayers/{taxpayerId}/tax-accounts
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
x-api-key: YOUR_API_KEY
{
"externalId": "my_tax_account_123",
"taxEntityId": "039bc3f4-d65e-73f7-8133-f5800e825511",
"type": "Personal",
"taxAuthority": "US_IRS"
}
HTTP Response:
HTTP/1.1 201 Created
Content-Type: application/json
{
"id": "059bc3f4-d65e-73f7-8133-f5800e825513",
"externalId": "my_tax_account_123"
}
List Tax Accounts
Sequence of Events:
- Your system sends a request to list all tax accounts associated with a specific taxpayer
- You can filter tax accounts by
externalIdif needed - Remitian responds with a paginated list of tax accounts
HTTP Request:
GET https://public-api.remitian.com/v1/taxpayers/{taxpayerId}/tax-accounts?externalId=my_tax_account_123
Authorization: Bearer YOUR_ACCESS_TOKEN
x-api-key: YOUR_API_KEY
HTTP Response:
HTTP/1.1 200 OK
Content-Type: application/json
{
"items": [
{
"id": "059bc3f4-d65e-73f7-8133-f5800e825513",
"externalId": "my_tax_account_123",
"taxEntityId": "039bc3f4-d65e-73f7-8133-f5800e825511",
"type": "Personal",
"taxAuthority": "US_IRS"
}
],
"currentPage": 1,
"pageSize": 10,
"totalCount": 1,
"totalPages": 1
}
Tip: To create a taxpayer, its tax entities and their tax accounts in a single call, see Provision a Taxpayer.