---
title: Tax identity verifications (connections)
description: Verify a tax entity with a tax authority, discover required fields from the catalog, and follow each verification's status.
---
[Skip to content](https://help.remitian.com/tax-identity-verifications-connections#main-content)
English
Show submenu for translations
[More support](https://help.remitian.com/kb-tickets/new?hsLang=en)
Open main navigation
Close main navigation
- English
Show submenu for translations
- [More support](https://help.remitian.com/kb-tickets/new)
- [Contact us](mailto:support@remitian.com)
[Contact us](mailto:support@remitian.com)
How can we help you?
- There are no suggestions because the search field is empty.
1. [Help Center](https://help.remitian.com/?hsLang=en)
2. [API](https://help.remitian.com/api?hsLang=en)
3. [Setting up firms and taxpayers](https://help.remitian.com/api?hsLang=en#setting-up-firms-and-taxpayers)
# Tax identity verifications (connections)
## Verify a tax entity with a tax authority, discover required fields from the catalog, and follow each verification's status.
### What it is
A tax identity verification, also called a connection, checks a tax entity's details with one tax authority. Remitian submits the information that authority requires and tracks the result. Only the latest verification per tax authority is valid for a tax entity; earlier ones are kept as history.
### When you need it
When a tax entity needs to be verified with a tax authority, for example the IRS or a state department of revenue. The tax entity must already have a tax account for that authority.
### How it works
1. Make sure the tax entity has a tax account for the tax authority you want to verify.
2. Call `GET /v1/tax-identity-verifications/connection-types` to get the fields that authority requires. Each connection type is named `{TaxAuthority}Individual` or `{TaxAuthority}Business` (for example `IrsIndividual`) and must match the tax entity type. The catalog can be cached for 24 hours, so you never hardcode the fields.
3. Create the verification with `POST /v1/taxpayers/{taxpayerId}/tax-entities/{taxEntityId}/tax-identity-verifications`, sending the `type`, `taxYear` and the catalog fields.
4. Follow it with the `taxIdentityVerification.*` webhooks, or with the latest verification endpoint (`.../tax-identity-verifications/latest?taxAuthority=...`).
5. On `Failed`, read `errors`, correct the details and create a new verification.
| Status | Meaning |
| --- | --- |
| `Created` | Recorded, about to be submitted. |
| `Requested` | Submitted to the tax authority, waiting for a result. |
| `PendingManualReview` | Remitian is reviewing it manually. |
| `AwaitingConfirmation` | Waiting for a confirmation step before the result is final. |
| `Success` | The tax authority verified the identity. |
| `Failed` | Rejected. `errors` holds the authority's messages. You can try again. |
| `FailedMaxReached` | Too many failed attempts. The authority is locked for this tax entity. |
### Verification in Canada
Canadian tax accounts do not use tax authority connections. Instead, no Canadian payment is processed until the taxpayer user passes an identity check (KYC). `CanadianBusiness` and `CanadianTrust` tax entities also need a business check (KYB). This applies whether the payment comes from the API, the Remitian portal or a bulk upload.
- **Identity check:** start it and check its status through the API. See the Canadian user KYC section of the docs.
- **Business check:** not available through the API. The firm completes it in the Remitian portal.
### Common questions
### Why did creating a verification return 409 Conflict?
A new verification is only accepted when the latest one for that tax authority is `Failed`, `Created` or `PendingManualReview`. You get `409` while the latest one is `Requested` or `AwaitingConfirmation`, once it has reached `Success`, or after the maximum number of failed attempts.
### Should I poll or use webhooks?
Use webhooks: `taxIdentityVerification.Created.v1`, `Succeeded.v1` and `Failed.v1`. An event carries the status at the moment it was raised, so read the latest verification before acting on it. That endpoint is the source of truth.
### Why does the request return 400?
Usually a missing or unknown `type`, a missing required field, an invalid `taxYear`, or a connection type that does not match the tax entity (for example a `Business` type on an individual).
### Why does the latest verification endpoint return 404?
The tax entity has never been verified with that tax authority, or the tax entity belongs to another taxpayer.
Full documentation
- [Use Case 6: Manage tax identity verifications](https://docs.remitian.com/products/wqptjtsou5/kfersio9vk/index.html)
- [Webhooks (verification events and payloads)](https://docs.remitian.com/products/wqptjtsou5/vxnky5hmua/index.html)
- [Accounting Firms](https://help.remitian.com/accounting-firms?hsLang=en#main-content)
- [Account Management](https://help.remitian.com/accounting-firms?hsLang=en#account-management)
- [Payment Management](https://help.remitian.com/accounting-firms?hsLang=en#payment-management)
- [Client Management](https://help.remitian.com/accounting-firms?hsLang=en#client-management)
- [APIs](https://help.remitian.com/accounting-firms?hsLang=en#apis)
- [Tax Payer](https://help.remitian.com/tax-payer?hsLang=en#main-content)
- [Payment Management](https://help.remitian.com/tax-payer?hsLang=en#payment-management)
- [Account Management](https://help.remitian.com/tax-payer?hsLang=en#account-management)
- [Frequently Asked Questions (FAQ)](https://help.remitian.com/frequently-asked-questions-faq?hsLang=en#main-content)
- [Account Management](https://help.remitian.com/frequently-asked-questions-faq?hsLang=en#account-management)
- [Payment Management](https://help.remitian.com/frequently-asked-questions-faq?hsLang=en#payment-management)
- [KYC & KYB Frequently Asked Questions](https://help.remitian.com/frequently-asked-questions-faq?hsLang=en#kyc-kyb-frequently-asked-questions)
- [Changelog](https://help.remitian.com/changelog?hsLang=en#main-content)
- [Remitian](https://help.remitian.com/changelog?hsLang=en#remitian)
- [TaxPay](https://help.remitian.com/changelog?hsLang=en#taxpay)
- [API](https://help.remitian.com/changelog?hsLang=en#api)
- [Video Library](https://help.remitian.com/video-library?hsLang=en)
- [API](https://help.remitian.com/api?hsLang=en#main-content)
- [Getting Started](https://help.remitian.com/api?hsLang=en#getting-started)
- [Authentication and security](https://help.remitian.com/api?hsLang=en#authentication-and-security)
- [Setting up firms and taxpayers](https://help.remitian.com/api?hsLang=en#setting-up-firms-and-taxpayers)
- [Tax payments](https://help.remitian.com/api?hsLang=en#tax-payments)
[](https://www.remitian.com)
© Remitian. The Standard for Tax Payments.
[mailto:email@email.com](mailto:email@email.com)
Copyright © 2025, Remitian Inc..