---
title: "GET /api/users/{id}/messages"
method: GET
path: "/api/users/{id}/messages"
tags: ["UserApi"]
---

# GET /api/users/{id}/messages

`GET /api/users/{id}/messages`

## Path parameters

- `id` integer, required

## Query parameters

- `inbox` 'Nothing' | 'Received' | 'Sent' | 'Notifications'
- `unread` boolean
- `anotherUserId` integer
- `start` integer
- `maxResults` integer
- `getTotalCount` boolean

## Response `200`

Success

- UserMessageContractPartialFindResult
  - `items` UserMessageContract[], nullable
    - `body` string, nullable
    - `createdFormatted` string, nullable
    - `highPriority` boolean
    - `id` integer
    - `inbox` 'Nothing' | 'Received' | 'Sent' | 'Notifications'
    - `read` boolean
    - `receiver` UserForApiContract
      - `active` boolean
      - `groupId` 'Nothing' | 'Limited' | 'Regular' | 'Trusted' | 'Moderator' | 'Admin'
      - `knownLanguages` UserKnownLanguageContract[], nullable
        - `cultureCode` string, nullable
        - `proficiency` 'Nothing' | 'Basics' | 'Intermediate' | 'Advanced' | 'Native'
      - `mainPicture` EntryThumbForApiContract
        - `mime` string, nullable
        - `name` string, nullable
        - `urlOriginal` string, nullable
        - `urlSmallThumb` string, nullable
        - `urlThumb` string, nullable
        - `urlTinyThumb` string, nullable
      - `memberSince` string, date-time
      - `oldUsernames` OldUsernameContract[], nullable
        - `date` string, date-time
        - `oldName` string, nullable
      - `verifiedArtist` boolean
      - `id` integer
      - `name` string, nullable
    - `sender` UserForApiContract
      - `active` boolean
      - `groupId` 'Nothing' | 'Limited' | 'Regular' | 'Trusted' | 'Moderator' | 'Admin'
      - `knownLanguages` UserKnownLanguageContract[], nullable
        - `cultureCode` string, nullable
        - `proficiency` 'Nothing' | 'Basics' | 'Intermediate' | 'Advanced' | 'Native'
      - `mainPicture` EntryThumbForApiContract
        - `mime` string, nullable
        - `name` string, nullable
        - `urlOriginal` string, nullable
        - `urlSmallThumb` string, nullable
        - `urlThumb` string, nullable
        - `urlTinyThumb` string, nullable
      - `memberSince` string, date-time
      - `oldUsernames` OldUsernameContract[], nullable
        - `date` string, date-time
        - `oldName` string, nullable
      - `verifiedArtist` boolean
      - `id` integer
      - `name` string, nullable
    - `subject` string, nullable
  - `term` string, nullable
  - `totalCount` integer

---

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