# List email threads

**GET /local-emails/{caseId}/threads**

Lists the imported email threads of a case with subject, participants, dates and tags, optionally filtered by mailbox, folder, domain, participant, tag or date. Hidden threads are left out unless includeHidden is set. On a case shared with opposing counsel, each side sees only the threads it may see.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Access token


## Parameters

### Path parameters

- **caseId** (string)


### Query parameters

- **page** (number)

- **perPage** (number)

- **skip** (number)
  If skip/limit not provided, page/perPage will take precedence

- **limit** (number)
  If skip/limit not provided, page/perPage will take precedence

- **sortOrder** (string)

- **folders** (array[string])

- **domains** (array[string])
  Filter by participant domain(s) (part after @), any-of. Case-insensitive.

- **excludeDomains** (array[string])
  Exclude items whose domain(s) match any of these (any-of). Case-insensitive. Must not overlap `domains`.

- **tags** (array[string])

- **excludeTags** (array[string])
  Exclude items carrying any of these tag ids. Must not overlap `tags`.

- **participants** (array[string])
  Filter by participant email address(es), any-of.

- **excludeEmails** (array[string])
  Exclude items whose participant address matches any of these (any-of). Must not overlap `participants`.

- **starred** (boolean)

- **unread** (boolean)

- **untagged** (boolean)
  When truthy (1/true), return only threads with no tags attached. Takes precedence over the `tags` filter.

- **startDate** (string(date-time))
  Only return threads whose `latestMessageReceivedDate` is at/after this instant (inclusive). Accepts an ISO-8601 date-time.

- **endDate** (string(date-time))
  Only return threads whose `latestMessageReceivedDate` is at/before this instant (inclusive). Accepts an ISO-8601 date-time.

- **sourceEmails** (array[string])

- **sortBy** (string)

- **includeLastMessage** (boolean)
  When truthy (1/true), populate lastMessageOrDraft (id/subject); otherwise it is returned as null. The message body is never included — use the thread `snippet` for previews, or fetch the body from the thread-emails endpoint.

- **includeHidden** (boolean)
  When true, include hidden threads (hiddenAt != null). Default false: hidden threads are excluded from the listing.

- **sharedStatus** (string)
  Opposing-council only. Narrows to threads in one sharing state; ignored for OL/OG callers.



## Responses
### 200


#### Body: application/json (object)
- **data** (object)

- **statusCode** (number)

- **timestamp** (string(date-time))



[Powered by Bump.sh](https://bump.sh)