# Return a Draft > **GET** `https://api.us.nylas.com/v3/grants/{grant_id}/drafts/{draft_id}` Source: https://developer.nylas.com/docs/reference/api/drafts/get-draft-id/ Return a draft by ID. **Authentication:** NYLAS_API_KEY, ACCESS_TOKEN ## Parameters ### Query parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `select` | string | No | Specify fields that you want Nylas to return, as a comma-separated list (for example, `select=id,updated_at`). This allows you to receive only the portion of object data that you're interested in. You can use `select` to optimize response size and reduce latency by limiting queries to only the information that you need. | | `query_imap` | boolean | No | (IMAP, iCloud, and Yahoo only) When `true`, Nylas queries from the IMAP server directly instead of the Nylas database. | ### Path parameters | Name | Type | Required | Description | |------|------|----------|-------------| | `grant_id` | string | Yes | ID of the grant to access. Use `/me/` to refer to the grant associated with an access token. | | `draft_id` | string | Yes | ID of the draft to access. Nylas recommends you URL-encode this field, or you might receive a [`404` error](/docs/api/errors/400-response/) if the ID contains special characters (for example, `#`). | ## Responses ### 200 - Draft - `request_id` (string) - The request ID. - `data` (object) - A draft of a message. You can edit a draft until you send it as a message. - `bcc` (array) - The name/email address pairs of the recipients to be BCC'd. - `name` (string) - `email` (string) **(required)** - `body` (string) - The body of the draft as either plain-text or HTML content. If the draft has both plain-text and HTML, Nylas returns the HTML version. - `cc` (array) - The name/email address pairs of the recipients to be CC'd. - `name` (string) - `email` (string) **(required)** - `attachments` (array) - An array of Attachment objects. For Google, linked Google Drive files are not included. For Microsoft, linked One Drive files are not included. - `id` (string) **(required)** - The ID of the attachment. - `content_type` (string) - The [MIME type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types/Common_types) of the attachment, used by the email client to determine how to display the attachment. If you don't provide a type, Nylas infers it from the file name. The value of this field is exactly the same as the email attachment's `Content-Type` header. The provider might set additional parameters, such as `name` and `charset`. Nylas returns an empty `content_type` field if an attachment file name contains non-ASCII characters (for example, accented characters like `ΓΌ`). This is because Google can't detect its content type. - `filename` (string) - The file name of the attachment. - `grant_id` (string) - The ID of grant for the connected user. - `content_id` (string) - (Inline attachments only) The alphanumeric `cid` from the `` tag in the message's HTML. For example, you might see something like `` in the message body. Sometimes, the `content_id` value is contained in angle brackets (for example, ``). - `content_disposition` (string) - (Not supported for Microsoft and EWS) The content disposition of the attachment. Usually, this is `inline` or `attachment` followed by the file name (for example, `inline; filename="some-image.jpeg"`). - `is_inline` (boolean) - If `true`, indicates that the attachment is an inline file. - `size` (integer) - The size of the attachment, in bytes. - `folders` (array) - A list of folder IDs. For Microsoft, only a single folder is supported. For Google, multiple folders may exist. - `from` (array) - An array containing a single name/email address pair, to set as the `From` header. - `name` (string) - `email` (string) - `grant_id` (string) - The ID of grant for the connected user. - `id` (string) - A globally unique object identifier for Microsoft accounts. An email address for Google accounts. - `metadata` (object) - The metadata associated with the object. For more information, see [Metadata](/docs/reference/api/#metadata). - `object` (string) - The object type of the response. In this case, `draft`. - `reply_to` (array) - An array of name/email address pairs that should receive replies to the message. - `name` (string) - `email` (string) **(required)** - `snippet` (string) - A short snippet of the message body (the first 100 characters, with any HTML tags removed). This is useful for displaying a preview of a draft message. - `starred` (boolean) - When `true`, shows that the Draft has been starred by the user. For EWS, this is only supported for Microsoft Exchange 2010 or later. - `subject` (string) - The subject line of the draft. - `thread_id` (string) - A reference to the parent Thread object. If this is a new draft, the thread is empty. - `to` (array) - The name/email address pairs of the recipients. - `name` (string) - `email` (string) **(required)** ### 400 - Bad Request - `request_id` (string) - The request ID. - `error` (object) - The response error object. - `type` (string) - The error type. - `message` (string) - The error message. - `provider_error` (object) - The error from the provider. ### 401 - Unauthorized - `request_id` (string) - The request ID. - `error` (object) - The response error object. - `type` (string) - The error type. - `message` (string) - The error message. - `provider_error` (object) - The error from the provider. ### 404 - Not Found - `request_id` (string) - The request ID. - `error` (object) - The response error object. - `type` (string) - The error type. - `message` (string) - The error message. - `provider_error` (object) - The raw error from the provider, if available - `code` (string) - `message` (string) ### 429 - Rate Limit - `request_id` (string) - The request ID. - `error` (object) - The response error object. - `type` (string) - The error type. - `message` (string) - The error message. ### 504 - Provider Failure - `request_id` (string) - The request ID. - `error` (object) - The response error object. - `type` (string) - The error type. - `message` (string) - The error message. ## Code samples ### cURL ```bash curl --compressed --request GET \ --url 'https://api.us.nylas.com/v3/grants//drafts/' \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' ``` ### Node.js SDK ```javascript import Nylas from "nylas"; const nylas = new Nylas({ apiKey: "", apiUri: "", }); async function fetchDraftById() { try { const events = await nylas.drafts.find({ identifier: "", draftId: "", }); console.log("Events:", events); } catch (error) { console.error("Error fetching calendars:", error); } } fetchDraftById(); ``` ### Python SDK ```python from nylas import Client nylas = Client( "", "" ) grant_id = "" draft_id = "" draft = nylas.drafts.find( grant_id, draft_id, ) print(draft) ``` ### Ruby SDK ```ruby # Load gems require 'nylas' # Initialize Nylas client nylas = Nylas::Client.new( api_key: "" ) draft, _ = nylas.drafts.find(identifier: "", draft_id: "") puts draft ``` ### Java SDK ```java import com.nylas.NylasClient; import com.nylas.models.*; public class ListDraft { public static void main(String[] args) throws NylasSdkTimeoutError, NylasApiError { NylasClient nylas = new NylasClient.Builder("").build(); Response draft = nylas.drafts().find("", ""); assert draft.getData().getTo() != null; System.out.printf(" %s | %s | %s", draft.getData().getId(), draft.getData().getTo().get(0).getEmail(), draft.getData().getSubject()); } } ``` ### Kotlin SDK ```kotlin import com.nylas.NylasClient import com.nylas.models.* fun main(args: Array) { val nylas: NylasClient = NylasClient( apiKey = "" ) val draft = nylas.drafts().find("", "") println("${draft.data.id} | " + "${draft.data.to?.get(0)?.email} | " + "${draft.data.subject}") } ```