---
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

---

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