---
schema_version: "1"
id: 5c302d47587a6f7cc2e380ca176444c70db9572fbe809c81a09b1de382086f2a
title: GET /ott/v1/send/{messageId}
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/OTTretrieveSentMessage.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_chat_messaging/OTTretrieveSentMessage.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 53d954e3a3c9a72b99d8aa40f2b57ff00e2097972e769e77316e08d261b830b1
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# GET /ott/v1/send/{messageId}

## Overview

Retrieves all the information about an existing OTT send message request.

### URL Parameters

<!--complex table-->

| Name          | Type   |              | Description                                                                                                                               |
| ------------- | ------ | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------- |
| **messageId** | string | **Required** | Id of the send request to be retrieved. Id can be user-defined MessageKey or ottRequestId returned as a response to send message request. |

### Responses

| Status  | Name                 | Type     | Description                                                                     |
| ------- | -------------------- | -------- | ------------------------------------------------------------------------------- |
| **200** | &nbsp;               | &nbsp;   | **success**                                                                     |
| &nbsp;  | requestBody          | object   | Returns the request body.                                                       |
| &nbsp;  | status               | array    | Status of the message send request.                                             |
| &nbsp;  | status.event         | string   | Indicates the type of event with values: Created, Queued, Sent, Error (if any). |
| &nbsp;  | status.eventDateTime | datetime | Timestamp indicating when the event occured.                                    |
| &nbsp;  | &nbsp;               | &nbsp;   | &nbsp;                                                                          |
| **403** | &nbsp;               | &nbsp;   | **Forbidden**                                                                   |
| &nbsp;  | message              | string   | Error message.                                                                  |
| &nbsp;  | errorcode            | number   | Error code.                                                                     |
| &nbsp;  | documentation        | string   | Documentation for the error code.                                               |
| &nbsp;  | &nbsp;               | &nbsp;   | &nbsp;                                                                          |
| **404** | &nbsp;               | &nbsp;   | **Not Found**                                                                   |
| &nbsp;  | message              | string   | Error message.                                                                  |
| &nbsp;  | errorcode            | number   | Error code.                                                                     |
| &nbsp;  | documentation        | string   | Documentation for the error code.                                               |

## Usage

### Example Request

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
GET /ott/v1/send/812ed7d7-f11c-43dd-9eaa-b32ca3264278
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN
```

### Example Response: Retrieve a Send Message Request to Messenger

```
HTTP/1.1 200 OK

{
    "requestBody": {
        "messageKey": "e1c3514160f969e52b0d",
        "ottRequestId": "942adfff-817e-4276-bca6-c1cbcd7b6241",
        "from": {
            "senderType": "messenger",
            "senderId": "200012913364042"
        },
        "to": {
            "ottId": "1061820367222105"
        },
        "message": {
            "subject": "Message Name",
            "contents": [
                {
                    "type": "text",
                    "text": "Hello, Messenger World!",
                    "duration": 0,
                    "isReusable": false
                }
            ],
            "customKeys": [
                {
                    "messagingType": "RESPONSE"
                }
            ]
        },
        "validityPeriod": 30
    },
    "status": [
        {
            "event": "Created",
            "eventDateTime": "2018-05-24T13:36:52.747"
        },
        {
            "event": "Queued",
            "eventDateTime": "2018-05-24T13:37:01.29"
        },
        {
            "event": "Sent",
            "eventDateTime": "2018-05-24T13:37:01.337"
        }
    ]
}
```

### Example Response: Retrieve Send Message Request to LINE

```
HTTP/1.1 200 OK

{
    "requestBody": {
        "messageKey": "e1c35141-6e5c-4bc2-813b-60f969e52b0d",
        "ottRequestId": "2dd53e4a-56a5-497a-b5f2-1a34187e1641",
        "from": {
            "senderType": "line",
            "senderId": "1415451353"
        },
        "to": {
            "ottId": "U0098560c6da67ea9cab11d4405e3c018"
        },
        "message": {
            "subject": "Message Name",
            "contents": [
                {
                    "type": "text",
                    "text": "Hello, LINE World!",
                    "duration": 0,
                    "isReusable": false
                }
            ],
            "customKeys": []
        },
        "validityPeriod": 30
    },
    "status": [
        {
            "event": "Created",
            "eventDateTime": "2018-05-24T14:58:14.36"
        },
        {
            "event": "Queued",
            "eventDateTime": "2018-05-24T14:58:15.01"
        },
        {
            "event": "Sent",
            "eventDateTime": "2018-05-24T14:58:15.337"
        }
    ]
}
```