---
title: "Return a scheduled message"
method: GET
path: "/v3/grants/{grant_id}/messages/schedules/{scheduleId}"
tags: ["Messages"]
---

# Return a scheduled message

`GET /v3/grants/{grant_id}/messages/schedules/{scheduleId}`

## Request

- Base URL: `https://api.us.nylas.com`
- URL: `https://api.us.nylas.com/v3/grants/{grant_id}/messages/schedules/{scheduleId}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Returns the specified scheduled message. You can retrieve both sent and unsent messages.

## Path parameters

- `scheduleId` string, required

## Response `200`

Schedule(s) Retrieved

- Schedules
  - `schedule_id` string, required: The ID of the scheduled message.
  - `status` object, required: The status of the specified scheduled message.
    - `code` string: The status code which describes the state of the specified scheduled message.
    - `description` string: A description of the status of the specified scheduled message.
  - `close_time` integer: The time that the message was sent, or failed to send, in seconds using the Unix timestamp format.

## Other responses

- `404`: Not Found

---

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