---
title: "returns list of chores for given user"
method: GET
path: "/kkid/chorelist"
tags: ["KKid"]
---

# returns list of chores for given user

`GET /kkid/chorelist`

By passing in the appropriate options, you can search for
chores assigned to a given user within the authenticated user's master account

## Query parameters

- `kidUsername` string
- `day` 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday' | 'Weekly'
- `status` string
- `blockDash` boolean
- `optional` boolean
- `canSteal` boolean
- `includeCalendar` boolean

## Response `200`

search results matching criteria

- Chorelist — chorelist
  - `success` integer
  - `chore` Chore[]
    - `idChoreList` integer
    - `kid` string
    - `day` string
    - `choreName` string
    - `choreDescription` string
    - `choreNumber` integer
    - `nfcTag` string
    - `status` string
    - `blockDash` boolean
    - `oneTime` boolean
    - `extraAllowance` integer
    - `stolen` boolean
    - `stolenBy` string
    - `optional` boolean
    - `reassignable` boolean
    - `reassigned` boolean
    - `updated` string
    - `updatedBy` string
    - `startDate` string
    - `notes` string
    - `latitude` integer
    - `longitude` integer
    - `altitude` integer
    - `isCalendar` boolean
    - `requireObjectDetection` string
    - `aiIcon` string

## Other responses

- `202` — Accepted- Access Granted but data flow did not complete due to an unknown error.
- `206` — No Data Found.
- `400` — bad input parameter
- `401` — Unauthorized- API credentials not supplied. Ensure you have passed proper Username and Password parameters
- `403` — Forbidden- User access is denied. API user either does not have access or has been banned/locked.
- `405` — Method Not Allowed- API user does not have access to use this method
- `412` — API Access Denied! Your API key is invalid, expired, or not supplied!

---

[API](https://skmtc.net/kumpeapps/apis/kumpeapps-api.md) · [All operations](https://skmtc.net/kumpeapps/apis/kumpeapps-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kumpeapps/kumpeapps-api/versions/0f0bb0e58cc2/schema)