---
title: "Retrieve contact tax details"
method: GET
path: "/v2/contacts/{contactId}/tax-details"
deprecated: true
---

# Retrieve contact tax details

`GET /v2/contacts/{contactId}/tax-details`

## Request

- Base URL: `https://api.slash.com`
- URL: `https://api.slash.com/v2/contacts/{contactId}/tax-details`
- Auth: API key in header `X-API-Key`

> **Deprecated.**

Deprecated; use `GET /v2/recipients/{recipientId}/tax-details`.

## Path parameters

- `contactId` string, required

## Response `200`

The contact's current tax details.

- RecipientTaxDetails: The tax details on file for a recipient. `federalTaxClassification` is set for US recipients only. The taxpayer identification number itself is never returned.
  - `recipientId` string, required: The recipient these details belong to.
  - `legalName` string, required: Legal name as reported for tax purposes.
  - `countryCode` string, required: ISO 3166-1 alpha-2 country of tax residence.
  - `federalTaxClassification` 'individual' | 'sole_proprietor' | 'c_corporation' | 's_corporation' | 'partnership' | 'trust_estate' | 'llc_c' | 'llc_s' | 'llc_partnership' | 'other': Federal tax classification as reported on a W-9.
  - `taxIdType` 'ssn' | 'ein' | 'itin' | 'foreign_tin', required: Kind of taxpayer identification number on file. The number itself is never returned.
  - `address` Address
    - `line1` string, required
    - `line2` string
    - `city` string, required
    - `state` string
    - `postalCode` string
    - `countryCode` string: ISO 3166-1 alpha-2 country code.
  - `email` string: Email address for tax correspondence.
  - `informationRequestId` string: Information request the recipient submitted these details through, with the `le_c_info_req_` prefix. Absent when the details were entered in the Slash dashboard.
  - `updatedAt` string, date-time, required: When these tax details were last written.

## Other responses

- `400`: - `invalid_request (request shape)` — The body, query, or headers failed validation, or a required header is missing. `details` has one entry per failing location, keyed by JSON pointer or header name.
- `401`: - `unauthorized` — API key authentication is missing or invalid.
- `403`: - `forbidden (legal entity)` — The credential is not permitted to act for the selected legal entity. - `not_available` — Public API v2 is not yet available. Use [Public API v1](https://docs.slash.com/introduction) in the meantime. - `user_api_key_required` — The API key is scoped to a legal entity rather than a user. Every v2 request needs a user API key, created under Settings → API keys in the Slash dashboard, together with the `x-legal-entity` header.
- `404`: - `not_found` — No resource matches the identifier. When the identifier is a field of the request, `details` names that `field` and the `id` it received. - `tax_details_not_on_file` — The recipient exists and the credential can view it, but it has no tax details on file. They are filled in when the recipient submits an information request that asks for `tax`, or when someone enters them in the Slash dashboard.
- `429`: The request exceeded the applicable rate limit. The response body is plain text, not the error object; clients must not depend on its wording.
- `500`: - `internal` — Slash could not complete the request. Quote `referenceId` when contacting Slash support.

## Changes

- **2026-10-16** `8b5d371ffeea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/slashfi/apis/slash-public-api/changes/v2/contacts/:contactId/tax-details/get.md)

---

[API](https://skmtc.dev/slashfi/apis/slash-public-api.md) - [All operations](https://skmtc.dev/slashfi/apis/slash-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/slashfi/apis/slash-public-api/revisions/eaed2d63c9e2?raw)