---
title: "List Tax Id Kinds"
method: GET
path: "/api/fiscal/tax-id-kinds"
tags: ["fiscal"]
---

# List Tax Id Kinds

`GET /api/fiscal/tax-id-kinds`

## Request

- Base URL: `https://demo.usesecuro.com` (the document declares no server; this is the origin it was published from)
- URL: `https://demo.usesecuro.com/api/fiscal/tax-id-kinds`
- Auth: OAuth 2
  - Password
  - Token URL: `/api/auth/login`
- TypeScript: <https://skmtc.dev/usesecuro/apis/securo/docs/api/fiscal/tax-id-kinds/get.ts> (a function with typed inputs; its response is checked against the schema)

Document kinds for the active workspace, plus which country uses what.

Two lists, because the picker needs both:

  - `kinds`: every document, with the ones this jurisdiction asks for
    first and flagged `offered`. The rest stay selectable, since a
    counterparty's country is not the workspace's.
  - `jurisdictions`: the country-to-documents map, so the picker can
    group by country and be searched by country name. It has to come
    from here: which documents a country uses *is* the pack, and a
    second copy in the frontend would drift from it.

## Headers

- `X-Workspace-Id` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-05** `416a7752fec4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usesecuro/apis/securo/changes/api/fiscal/tax-id-kinds/get.md)

---

[API](https://skmtc.dev/usesecuro/apis/securo.md) - [All operations](https://skmtc.dev/usesecuro/apis/securo/llms.txt) - [OpenAPI document](https://skmtc.dev/usesecuro/apis/securo/revisions/416a7752fec4?raw)