---
title: "Load Contacts in List"
method: GET
path: "/lists/{listname}/contacts"
tags: ["Lists"]
---

# Load Contacts in List

`GET /lists/{listname}/contacts`

Returns a list of contacts. Required Access Level: ViewContacts

## Path parameters

- `listname` string, string, required — string

## Query parameters

- `limit` integer — integer
- `offset` integer — integer

## Response `200`

OK

- Contact[]
  - `Email` string, string — Proper email address.
  - `Status` 'Transactional' | 'Engaged' | 'Active' | 'Bounced' | 'Unsubscribed' | 'Abuse' | 'Inactive' | 'Stale' | 'NotConfirmed'
  - `FirstName` string, string — First name.
  - `LastName` string, string — Last name.
  - `CustomFields` object — A key-value collection of custom contact fields which can be used in the system.
  - `Consent` ConsentData
    - `ConsentIP` string, string — IP address of consent to send this contact(s) your email. If not provided your current public IP address is used for consent.
    - `ConsentDate` string, date-time, nullable — Date of consent to send this contact(s) your email. If not provided current date is used for consent.
    - `ConsentTracking` 'Unknown' | 'Allow' | 'Deny'
  - `Source` 'DeliveryApi' | 'ManualInput' | 'FileUpload' | 'WebForm' | 'ContactApi' | 'VerificationApi' | 'FileVerificationApi' | 'PilotBillingPlan' | 'PaidNewsletter'
  - `SourceInfo` string, string
  - `DateAdded` string, date-time — Date of creation in YYYY-MM-DDThh:ii:ss format
  - `DateUpdated` string, date-time, nullable — Last change date
  - `StatusChangeDate` string, date-time, nullable — Date of last status change.
  - `Activity` ContactActivity
    - `TotalSent` integer — Total emails sent.
    - `TotalOpened` integer — Total emails opened.
    - `TotalClicked` integer — Total emails clicked
    - `TotalFailed` integer — Total emails failed.
    - `LastSent` string, date-time, nullable — Last date when an email was sent to this contact
    - `LastOpened` string, date-time, nullable — Date this contact last opened an email
    - `LastClicked` string, date-time, nullable — Date this contact last clicked an email
    - `LastFailed` string, date-time, nullable — Last date when an email sent to this contact bounced
    - `LastIP` string, string — IP from which this contact opened or clicked their email last time
    - `ErrorCode` integer, nullable — Last RFC Error code if any occurred
    - `FriendlyErrorMessage` string, string — Last RFC error message if any occurred

---

[API](https://skmtc.net/elasticemail/apis/megamail-api.md) · [All operations](https://skmtc.net/elasticemail/apis/megamail-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elasticemail/megamail-api/versions/1a0ebb83f676/schema)