---
title: "List of tasks by category"
method: GET
path: "/v1/{facility_id}/tasks"
tags: ["api-v1-tasks"]
---

# List of tasks by category

`GET /v1/{facility_id}/tasks`

Returns tasks for a specific category.

**Category Parameter:**
You can use either the category/subcategory `id` or `name` from the `task_categories` endpoint.

**Available Categories and Subcategories:**

- `my_tasks` — User-specific tasks (notes, reminders)

- `delinquency` — Delinquency-related tasks (calls, notices, auctions, overlocks)
    - Dynamic subcategories based on event types (e.g., `DelinquencyTenantEvent`, `DelinquencyCallEvent`, `DelinquencyTenantEvent`, etc.)

- `occupancy` — Move-ins, move-outs, transfers
    - Dynamic subcategories based on event types (e.g., `MoveInUnitEvent`, `MoveOutUnitEvent`, `TransferUnitEvent`)

- `unit_tasks` — Cleaning and maintenance tasks
    - Dynamic subcategories based on event types (e.g., `CleaningUnitEvent`, `MaintenanceUnitEvent`)

- `leads_and_reservations` — Lead follow-ups and reservation management

    - `leads` — Lead management subcategory
        - `follow_up` — Leads requiring follow-up
        - `wait_list` — Leads on waiting list
        - `close` — Leads to be closed

    - `reservations` — Reservation management subcategory
        - `follow_up` — Reservations requiring follow-up
        - `scheduled_move_in` — Scheduled move-ins
        - `missed_move_in` — Missed move-in appointments
        - `cancel` — Reservations to be cancelled

- `esign_needed` — E-signature tasks
    - May have `EsignNeeded` subcategory depending on facility configuration

- `billing` — Billing-related tasks
    - Dynamic subcategories based on event types (e.g., `CreditTenantEvent`, `PaymentEvent`)

- `emails` — Email tasks and bounced emails
    - Dynamic subcategories based on event types (e.g., `EmailBouncedEvent`)

- `sms` — SMS-related tasks
    - Dynamic subcategories based on event types

- `insurance` — Insurance expiration/renewal tasks
    - May have excluded insurance subcategories when auto-protect is enabled
    - Dynamic subcategories like `Insurance Expired-Excluded`, `Insurance Expiring-Excluded`

- `credit_cards` — Credit card expiration tasks

- `future_move_ins` — Future move-in scheduling

- `reviews` — Customer review management

- `support_cases` — Support case management

- `checklist_rejected` — Rejected delinquency checklists
    - Dynamic subcategories for each rejected checklist (links to specific tenant ledgers)

- `cloud_access` — Cloud access management
- `online_move_ins` — Online move-in tasks
- `print_batches` — Print batch tasks
- `refunds_owed` — Refund processing
- `inventory` — Inventory management

**Dynamic Subcategories:**
Many categories automatically create subcategories based on:
- Event types within the category
- Business rules (e.g., subcategorization when ≥10 tasks and ≥2 types)
- Facility-specific configurations
- Categories in the always-subcategorize list

**Categories with Links:**
Some categories have `href` values pointing to specific pages in the web interface.
These categories will return empty `tasks` arrays since they redirect to specialized views.

**Task Types:**
- **Event Objects** — Standard facility events with UUIDs (move-ins, delinquency tasks, etc.)
- **Custom Objects** — Special task types like `ChecklistRejectedEvent`

## Path parameters

- `facility_id` number, required

## Query parameters

- `category` string, required

## Response `200`

ok

---

[API](https://skmtc.dev/storedgefms/apis/storable-edge-api-params-in-body.md) · [All operations](https://skmtc.dev/storedgefms/apis/storable-edge-api-params-in-body/llms.txt) · [OpenAPI document](https://skmtc.dev/storedgefms/apis/storable-edge-api-params-in-body/revisions/50fea30c1954?raw)