---
title: "Retrieve messages"
method: GET
path: "/rts/messages/"
tags: ["rts_messages"]
---

# Retrieve messages

`GET /rts/messages/`

## Request

- Base URL: `https://api.angelcam.com/v1`
- URL: `https://api.angelcam.com/v1/rts/messages/`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://my.angelcam.com/oauth/authorize/`, token URL `https://my.angelcam.com/oauth/token/`
    - Password, token URL `https://api.angelcam.com/oauth/token/`
    - Scopes: `messages_access`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/angelcam/apis/angelcam-api/docs/rts/messages/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves list of user messages

## Query parameters

- `limit` integer
- `next` string, uri

## Response `200`

OK

- MessageListResponse
  - `count` integer, required: Count of all messages
  - `next` string, uri, nullable, required: Next page from pagination
  - `previous` string, uri, nullable, required: Previous page from pagination
  - `results` MessageObject[], required: List of messages
    - `id` number, required: Message ID
    - `created_at` string, required: Time when message was created, format `%Y-%m-%dT%H:%M:%SZ`
    - `title` string, required: Message title
    - `type` 'my_incident' | 'shared_incident' | 'arming' | 'trigger_action' | 'open_incident_verification' | 'verify_incident' | 'close_incident' | 'arrow_status_online' | 'arrow_status_offline' | 'camera_status_online' | 'camera_status_offline', required: Message type. Can be used to decide for instance priority of the message.
    - `short_message` string, required: Short version of message. Use short version for example in notification list
    - `long_message` string, required: More detailed version of message. Use long version in message detail or when sending via e-mail.
    - `is_read` boolean, required: Whether message was read by user.
    - `read_at` string: Time when message was read, format `%Y-%m-%dT%H:%M:%SZ`
    - `image` string: URL of image that is related to the message.
    - `action_url` string: URL to a particular screen in webapp or mobile app that is related to this message. Required when `show_detail == false`
    - `action_label` string: Label for button that should redirect to action_url
    - `show_detail` boolean, required: Whether to show detail of message or redirect user directly to `action_url`
    - `incident_sharing_url` string: URL that can be used for incident verification by third parties. The URL leads to a web page where all cameras from the affected location can be viewed (live streams + the last two hours of recording). The URL is valid for one hour after the corresponding incident is created. This field will be `null` if the message type isn't `my_incident` or if the URL is no longer valid.

## Other responses

- `400`: Query params are invalid.
- `401`: Missing or invalid authorization.
- `403`: Missing permission.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/angelcam/apis/angelcam-api.md) - [All operations](https://skmtc.dev/angelcam/apis/angelcam-api/llms.txt) - [OpenAPI document](https://skmtc.dev/angelcam/apis/angelcam-api/revisions/dd1cdc3f2c23?raw)