---
title: "Get status"
method: GET
path: "/inbox/v1/proactive-messaging/{correlationId}"
tags: ["Inbox"]
---

# Get status

`GET /inbox/v1/proactive-messaging/{correlationId}`

## Request

- Base URL: `https://platform.hootsuite.com`
- URL: `https://platform.hootsuite.com/inbox/v1/proactive-messaging/{correlationId}`
- Auth: OAuth 2
  - Authorization code: `https://platform.hootsuite.com/oauth2/auth`
  - Token URL: `https://platform.hootsuite.com/oauth2/token`

Get the status overview for a sent proactive message

## Path parameters

- `correlationId` string, required

## Response `200`

Success

- StatusOverviewResponse
  - `correlationId` string: The correlation id of the sent message.
  - `total` string: The total number of sent proactive messages.
  - `statuses` object: An overview with the number of messages per status
    - `PROCESSING` number: Number of proactive messages that are queued for sending.
    - `FAILED` number: Number of proactive messages that failed to send.
    - `SENT` number: Number of proactive messages that are sent.
    - `DELIVERED` number: Number of proactive messages that are sent and delivered.
    - `DELIVERING_FAILED` number: Number of proactive messages that are sent but could not be delivered.

## Other responses

- `400`: The request is malformed.
- `401`: Unauthorized: when using an invalid or expired access token

---

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