# Newsletter by ID (deprecated)

Retrieve details on the configuration of a specific newsletter. CampaignDraft and Newsletter objects are differentiated by the EditMode values - we recommend using CampaignDraft, as Newsletter objects are ones created using the legacy Mailjet template builder. To obtain a valid newsletter_ID, first call GET /v3/REST/newsletter to list your newsletters.

Endpoint: GET /v3/REST/newsletter/{newsletter_ID}
Version: 1.0.0
Security: basicAuth

## Path parameters:

  - `newsletter_ID` (integer, required)
    Unique numeric ID of the newsletter you want to retrieve.
    Example: 5000

## Response 200 fields (application/json):

  - `Count` (integer)
    Indicates the number of objects in the Data array.

  - `Data` (array)
    A JSON array containing a list of objects returned by this endpoint.

  - `Data.CampaignID` (integer)
    Unique numeric ID for this newsletter.

  - `Data.ContactsListID` (integer)
    Unique numeric ID for the contact list linked to this newsletter. Required for successful sending of the campaign.

  - `Data.CreatedAt` (string)
    Timestamp of when the newsletter was created.

  - `Data.DeliveredAt` (string)
    Timestamp of when the newsletter was delivered to the campaign's recipients.

  - `Data.ID` (integer)
    Unique numeric ID for this newsletter.

  - `Data.IsHandled` (boolean)
    Indicates whether the newsletter has been sent out, or a test email was sent out, or not.

  - `Data.Locale` (string)
    Locale, in which the information is saved.

  - `Data.ModifiedAt` (string)
    Timestamp of when the newsletter was last modified.

  - `Data.SegmentationID` (integer)
    ID of the segment configuration (contactfilter) used for this newsletter.

  - `Data.Sender` (string)
    Unique numeric ID of the sender email address.

  - `Data.SenderEmail` (string)
    Email address of the sender.

  - `Data.Subject` (string)
    Subject line for the newsletter emails.

  - `Data.AXFraction` (number)
    Fraction of an AB Testing newsletter as a percentage of the total emails. Zero indicates the remainder.

  - `Data.AXFractionName` (string)
    Name of the AB Testing fraction.

  - `Data.AXTesting` (object)
    An ID reference to the respective AXTesting object.

  - `Data.Callback` (string)
    The callback URL used for this newsletter.

  - `Data.EditMode` (string)
    Edit mode for newsletter.

 - tool - Legacy drag-and-drop template editor
 - html - Legacy HTML editor

 Default value: tool

  - `Data.EditType` (string)
    Edit type.

Default value: full

  - `Data.Footer` (string)
    Specifies the footer type that will be generated - either the default one, or none.

Default value: default

  - `Data.FooterAddress` (string)
    The address that will be used in the footer.

  - `Data.FooterWYSIWYGType` (integer)
    Specifies what type of footer is used, based on selections available in the legacy drag-and-drop template builder.

  - `Data.HeaderFilename` (string)
    Indicates the URL link to where the file used in the header is located, if you have added one.

  - `Data.HeaderLink` (string)
    Indicates the URL link used in the header.

  - `Data.HeaderText` (string)
    The text content in the header.

  - `Data.HeaderUrl` (string)
    URL used in header.

  - `Data.Ip` (string)
    The IP address used to create the newsletter.

  - `Data.IsStarred` (boolean)
    Indicates whether the newsletter is marked as Starred or not.

  - `Data.IsTextPartIncluded` (boolean)
    Indicates whether the newsletter email contains a plain text version or not.

  - `Data.Permalink` (string)
    Type of permalink that should be added to the newsletter. The default permalink allows recipients to view an online version of the newsletter template online.

Default value: default

  - `Data.PermalinkHost` (string)
    Host for the permalink.

  - `Data.PermalinkWYSIWYGType` (integer)
    Deprecated property.

  - `Data.PolitenessMode` (integer)
    Deprecated property.

  - `Data.ReplyEmail` (string)
    Reply-to email address for the campaign.

  - `Data.SenderName` (string)
    Name of the sender, which will be visible to recipients.

  - `Data.Status` (integer)
    Status of the newsletter. Only newsletters in status newsletter or Programmed can be scheduled and sent out via /newsletter/{newsletter_id}/schedule or  /newsletter/{newsletter_id}/send.

- -3 - AXCancelled
- -2- Deleted
- -1 - Archived
- 0 - Draft
- 1 - Programmed (scheduled)
- 2 - Sent
- 3 - AXTested (AB Testing versions sent, but winning version not selected yet)
- 4 - AXSelected (AB Testing winning version selected and sent)

  - `Data.TemplateID` (integer)
    ID reference to the template the newsletter was generated from, or as which it was last saved. Changing the template ID will not update the content of the newsletter.

  - `Data.TestAddress` (string)
    Email address used as a sender for test emails of this newsletter.

  - `Data.Title` (string)
    Internal title for this newsletter.

  - `Data.Url` (string)
    URL where an online version of the newsletter can be found.

  - `Total` (integer)
    Indicates the number of objects in the Data array.


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields