POpostgrid
Mailing Lists

Get Mailing List

Retrieve a specific mailing list by its ID.

get/print-mail/v1/mailing_lists/{id}

Request

  • Base URL
    https://api.postgrid.com
  • URL
    https://api.postgrid.com/print-mail/v1/mailing_lists/{id}
  • Auth
    API key in header X-API-Key

Path parameters

idstring required

The unique identifier (mailing_list_...) for the mailing list.

Response

The requested mailing list details.

idstring required

A unique ID prefixed with mailing_list_

descriptionstring

An optional string describing this resource. Will be visible in the API and the dashboard.

metadataobject

See the section on Metadata.

liveboolean required

true if this is a live mode resource else false.

createdAtstring date-time required

The UTC time at which this resource was created.

updatedAtstring date-time required

The UTC time at which this resource was last updated.

status'creating_contacts' | 'removing_contacts' | 'counting_recipient_country_codes' | 'completed' required

Status of the mailing list processing.

Changes

No recorded changes to this operation across all 1 revision of this API.