---
title: "List a client's tax activities"
method: GET
path: "/internal/api/clients/tax-activities"
tags: ["CLIENT", "Tax Activities"]
---

# List a client's tax activities

`GET /internal/api/clients/tax-activities`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/clients/tax-activities`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Schedule C businesses, Schedule E rentals, Schedule F farms (from questionnaire repeatable instances) plus the principal residence — for activity-link dropdowns.

## Query parameters

- `client_id` string, uuid, required: Client ID
- `tax_year` integer, required: Tax year (1900-2100)
- `activity_type` string, nullable: Optional filter for whole-form links — one type or a comma-separated set (SCH_C / SCH_E / SCH_F / RESIDENCE). E.g. 'SCH_E,SCH_C' for a 1099-MISC or 'RESIDENCE,SCH_E,SCH_C' for a 1099-S. Empty/omitted returns all.

## Response `200`

Successful Response

- TaxActivityOption[]
  - `value` string, required: Stable activity id — questionnaire-instance UUID, or a synthetic id.
  - `label` string, required
  - `activity_type` string, required: SCH_C / SCH_E / SCH_F / FARM_RENTAL / K1_ENTITY / RESIDENCE.
  - `form` string, required
  - `property_label` string, nullable: Groups co-located activities in the picker.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)
