# Remove a tax ID from your account > The portal.tax_ids.delete operation: DELETE /api/v1/portal/me/tax_ids/{taxIdId} in the REST API and the portal_tax_ids_delete tool in the MCP server. Removes one of the signed-in customer's tax IDs (by its `id`, the canonical number). Later purchases are taxed without it; issued invoices don't change. Emits `customer.updated`. Customer portal only (`portal:write`). ## At a glance - **REST:** `DELETE /api/v1/portal/me/tax_ids/{taxIdId}` - **MCP tool:** `portal_tax_ids_delete` - **Operation ID:** `portal.tax_ids.delete` - **Scope:** Brand - **Permission:** `portal:write` - **Risk tier:** `write` - **Dry run:** Not supported - **Idempotency:** `Idempotency-Key` optional - **Modes:** Test and live - **Authentication:** A customer signed in to the customer portal (API keys can't call it) - **Since:** M9 ## Request ### Path parameters | Field | Type | Description | | --------- | ------ | ---------------------------------------------------------------------------- | | `taxIdId` | string | The tax ID's `id` on the customer: its canonical number, e.g. `ATU12345678`. | ### Body This operation takes no body. ## Response `200 OK` with a JSON object: | Field | Type | Description | | -------------------- | --------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- | | `object` | `"portal_account"` | | | `customerId` | `cus_…` ID | | | `livemode` | boolean | | | `email` | string | | | `name` | string or null | | | `businessName` | string or null | | | `type` | one of `individual`, `business`, `unknown` | | | `locale` | string or null | | | `billingAddress` | object or null | | | `taxIds` | array of object | | | `taxIds[].id` | string | The tax ID's identity on your account: its canonical number. | | `taxIds[].type` | string | | | `taxIds[].value` | string | | | `taxIds[].country` | string | | | `taxIds[].status` | one of `valid`, `invalid`, `unavailable`, `format_only`, `unverified` | The register's answer: `valid`, `invalid`, `unavailable`, `format_only` or `unverified`. | | `taxIds[].checkedAt` | date-time | | | `portalLastLoginAt` | date-time or null | | ## Examples ### Remove a VAT ID ```http DELETE /api/v1/portal/me/tax_ids/ATU00000000 Authorization: Bearer or_test_… ``` Response (`200`): ```json { "object": "portal_account", "customerId": "cus_01m4tx5nj8emwbyf7y9vcf48b1", "livemode": false, "email": "ana@example.com", "name": "Ana Novak", "businessName": null, "type": "individual", "locale": null, "billingAddress": { "line1": "Ring 1", "line2": null, "city": "Wien", "postalCode": "1010", "region": null, "country": "AT" }, "taxIds": [], "portalLastLoginAt": "2026-10-20T09:00:00.000Z" } ``` ## Errors | Code | HTTP status | When | What to do | | -------------------------------------------------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- | | [`validation_failed`](https://ownrecord.io/docs/reference/errors.md#validation_failed) | 400 | The tax ID's ID or another field is malformed. | Fix the fields listed in `details.issues` and send the request again. | | [`resource_not_found`](https://ownrecord.io/docs/reference/errors.md#resource_not_found) | 404 | You have no such tax ID (another customer's reads the same). | Check the ID and that your credentials are scoped to the right organization, entity, brand and mode. | | [`customer_deleted`](https://ownrecord.io/docs/reference/errors.md#customer_deleted) | 400 | Your account was deleted by the brand. | Create a new customer for this buyer. Deleted customers stay readable for the records they belong to, but can't be changed. | | [`version_conflict`](https://ownrecord.io/docs/reference/errors.md#version_conflict) | 409 | Your details changed at the same moment; retry. | Fetch the object again and retry the change. | | [`livemode_not_allowed`](https://ownrecord.io/docs/reference/errors.md#livemode_not_allowed) | 403 | The portal session is in the other mode than the request. | Use test mode, or credentials for the target's mode. Developers need live access granted by an organization owner or admin. | | [`permission_denied`](https://ownrecord.io/docs/reference/errors.md#permission_denied) | 403 | The caller isn't a customer signed in to this brand's portal (operators and API keys use the customer operations). | Ask an organization owner or admin for a role or scope that allows this action. | It can also return these [common errors](https://ownrecord.io/docs/reference.md#common-errors): [`api_version_unsupported`](https://ownrecord.io/docs/reference/errors.md#api_version_unsupported), [`invalid_json`](https://ownrecord.io/docs/reference/errors.md#invalid_json), [`unsupported_media_type`](https://ownrecord.io/docs/reference/errors.md#unsupported_media_type), [`authentication_required`](https://ownrecord.io/docs/reference/errors.md#authentication_required), [`api_key_invalid`](https://ownrecord.io/docs/reference/errors.md#api_key_invalid), [`scope_required`](https://ownrecord.io/docs/reference/errors.md#scope_required), [`idempotency_key_reused`](https://ownrecord.io/docs/reference/errors.md#idempotency_key_reused), [`idempotency_in_progress`](https://ownrecord.io/docs/reference/errors.md#idempotency_in_progress), [`dry_run_not_supported`](https://ownrecord.io/docs/reference/errors.md#dry_run_not_supported), [`rate_limited`](https://ownrecord.io/docs/reference/errors.md#rate_limited), [`internal_error`](https://ownrecord.io/docs/reference/errors.md#internal_error).