# ValidateTaxIdentifier

Validates a tax identifier.

`POST /tax-identifiers/validate`

**API:** Avalara E-Invoicing API
**Tag:** Tax Identifiers
**API Version:** 1.6
**Base URL:** https://api.sbx.avalara.com/einvoicing
**Authentication:** Bearer token

Source: https://developer.avalara.com/products/e-invoicing/api/v1.6/methods/Tax%20Identifiers/ValidateTaxIdentifier/

## Description

This endpoint verifies whether a given tax identifier is valid and properly formatted according to the rules of the applicable country or tax system.

## Parameters

| Name | Type | In | Required | Description |
|---|---|---|---|---|
| `avalara-version` | string | header | Yes | Header that specifies the API version to use (for example "1.6"). |
| `X-Avalara-Client` | string | header | No | Optional header for a client identifier string used for diagnostics (for example "Fingerprint"). |
| `X-Correlation-ID` | string | header | No | Optional correlation identifier provided by the caller to trace the call (for example "f3f0d19a-01a1-4748-8a58-f000d0424f43"). |

## Request Body

**Content-Type:** `application/json`
**Schema:** `TaxIdentifierRequest`

Represents a request to validate company’s tax identifier.

| Property | Type | Required | Description |
|---|---|---|---|
| `countryCode` | string | **Yes** | The two-letter ISO-3166 country code of the tax identifier. |
| `identifierType` | string | **Yes** | Type of the identifier. |
| `identifier` | string | **Yes** | The tax identifier of the company. |
| `extensions` | object | No | Optional field for adding additional details required by specific tax authorities. Refer to the GET /tax-identifiers/schema API endpoint for the full request structure for a given country. |

## Responses

| Status | Description | Schema |
|---|---|---|
| 200 | Validation completed. Returns a TaxIdentifierResponse object that includes countryCode and a value object with identifierType, identifier, and optional extensions when available. | `TaxIdentifierResponse` |
| 400 | Bad request. The request is invalid or contains missing or incorrect parameters. | `ErrorResponse` |
| 401 | Unauthorized. | `ErrorResponse` |
| 403 | Forbidden. | `ErrorResponse` |
| 429 | Rate limit exceeded. | `ErrorResponse` |
| 500 | Internal server error. | `ErrorResponse` |

### 200 Response: `TaxIdentifierResponse`

Represents the response for a tax identifier validation request.

| Property | Type | Required | Description |
|---|---|---|---|
| `countryCode` | string | **Yes** | The two-letter ISO-3166 country code of the tax identifier. |
| `value` | object | No |  |

## Example Request

```bash
curl -X POST "https://api.sbx.avalara.com/einvoicing/tax-identifiers/validate" \
  -H "Authorization: Basic <credentials>" \
  -H "Accept: application/json" \
  -d '{
  "countryCode": "",
  "identifierType": "",
  "identifier": "",
  "extensions": {}
}'
```