---
title: "Get the status of an outbound message"
method: GET
path: "/api/v1/messages/status/{id}"
tags: ["Message"]
---

# Get the status of an outbound message

`GET /api/v1/messages/status/{id}`

Get information about the current state of an outbound message. This can be used to check the transmission
state, size and destination of the message.

## Path parameters

- `id` string, hex, required

## Response `200`

Success

- MessageStatusResponse — Information about an outbound message
  - `dst` string, ipv6 — IP address of the receiving node
  - `state` union — The state of an outbound message in it's lifetime
    - 'pending' | 'received' | 'read' | 'aborted'
    - object
      - `sending` object
        - `pending` integer
        - `sent` integer
        - `acked` integer
  - `created` integer — Unix timestamp of when this message was created
  - `deadline` integer — Unix timestamp of when this message will expire. If the message is not received before this, the system will give up
  - `msgLen` integer — Length of the message in bytes

## Other responses

- `404` — Message not found

## Changes

- **2023-11-03** `dc2a386974c6` — 1 warning, 1 info
  - removed the optional property `msg_len` from the response with the `200` status
  - added the optional property `msgLen` to the response with the `200` status
- **2023-11-02** `e0eba3e5e2bc` — 1 breaking, 1 info
  - api path removed without deprecation
  - endpoint added
- **2023-10-27** `91adfc18403b` — 4 warning, 4 info
  - added the new `aborted` enum value to the `state/oneOf[subschema #1]/` response property for the response status `200`
  - added the new `pending` enum value to the `state/oneOf[subschema #1]/` response property for the response status `200`
  - added the new `read` enum value to the `state/oneOf[subschema #1]/` response property for the response status `200`
  - added the new `received` enum value to the `state/oneOf[subschema #1]/` response property for the response status `200`
  - …4 more
- **2023-10-27** `0ebb5659d3ca` — 1 info
  - endpoint added
- **2023-10-26** `1c37c167d50d` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/threefoldtech/apis/mycelium-management/changes/api/v1/messages/status/:id/get.md)

---

[API](https://skmtc.dev/threefoldtech/apis/mycelium-management.md) · [All operations](https://skmtc.dev/threefoldtech/apis/mycelium-management/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/threefoldtech/mycelium-management/revisions/65042c1a7b84/schema)