---
title: "Fetch messages"
method: GET
path: "/messages"
tags: ["messages"]
---

# Fetch messages

`GET /messages`

Search for messages of given candidate. Use jobId parameter to filter results to messages only for specific job application. Accessible only for users with ADMINISTRATOR role.

## Query parameters

- `candidateId` string, guid, required
- `jobId` string, guid
- `pageId` string
- `limit` integer

## Response `200`

Messages successfully fetched

- MessageView[]
  - `content` string
  - `createdOn` string, date-time
  - `visibility` 'PUBLIC' | 'INTERNAL'
  - `authorId` string
  - `context` Context
    - `applications` Application[]
      - `candidateId` string, guid
      - `jobId` string, guid

## Other responses

- `400` — with codes: * **CANDIDATE_NOT_FOUND** when candidate with given id does not exist * **JOB_NOT_FOUND** when job with given id does not exist * **APPLICATION_NOT_FOUND** when candidate does not have application for given job
- `403` — No permission to access messages

---

[API](https://skmtc.net/smartrecruiters/apis/apply-api.md) · [All operations](https://skmtc.net/smartrecruiters/apis/apply-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/smartrecruiters/apply-api/revisions/449bdc2516c9/schema)