Get Tax Rates

get/v1/tax-rates/{tax_rate_id}

Fetches a single tax rate by its public id within the active workspace. Read only, no side effects. Returns 404 when the id is unknown or falls outside the caller's workspace scope.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
tax_rate_id	string <uuid>	Yes	Public UUID of the tax rate.e.g. c9d0e1f2-0000-4000-8000-0000000000a9

Query parameters

Name	Type	Required	Description
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/tax-rates/{tax_rate_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The requested tax rate.

{
  "data": {
    "type": "tax_rate",
    "id": "c9d0e1f2-0000-4000-8000-0000000000a9",
    "attributes": {
      "tax_rate_id": "c9d0e1f2-0000-4000-8000-0000000000a9",
      "name": "US standard",
      "rate": 0,
      "tax_type": "sales_tax",
      "country": "US",
      "is_default": true,
      "is_active": true,
      "effective_from": "2026-01-01",
      "effective_to": null,
      "created_at": "2026-01-12T18:07:00Z",
      "updated_at": "2026-01-12T18:07:00Z",
      "deleted_at": null
    },
    "relationships": {
      "collected_account": {
        "data": {
          "type": "ledger_account",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "deductible_account": {
        "data": {
          "type": "ledger_account",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      }
    }
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}