---
schema_version: "1"
id: b72fa9f78587a4b07cf87f42ba5682caa2591b7ea61a7ef7e41f420350ac39f6
title: GET /messaging/v1/email/seed-lists
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/messageReadAllSeedListsForAccount.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/messageReadAllSeedListsForAccount.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 22b02f2610bf91f4c88a01356c88c130ee7f2354eb5bbada335cf92c8b5465d4
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# GET /messaging/v1/email/seed-lists

## Overview

Read all seed lists for an account. The MID and partner appId are used from authentication. The View user permission is required.

## Response

| **Status** | **Name** | **Type**        |            |     |     |     | **Description**                                                                               |
| ---------- | -------- | --------------- | --------------- | -------- | -------- | -------- | --------------------------------------------------------------------------------------------- |
| 200        |     |            |            |     |     |     | Successful response indicating the request passed validations.                                |
|       | count    | integer         |            |     |     |     | The count of seed-lists.                                                                      |
|       | page     | integer         |            |     |     |     | The page number.                                                                              |
|       | pageSize | integer         |            |     |     |     | The maximum of seed-lists allowed on a page under the current pagination settings.            |
|       | links    | object          |            |     |     |     | An object containing relevant links as name\:value pairs, the values are objects.             |
|       |     |            | **Name**        | **Type** |     |     |                                                                                          |
|       |     |            | self            | object   |     |     | The name `self` is a default object name, with the nested object.                             |
|       |     |            |            |     | **Name** | **Type** |                                                                                          |
|       |     |            |            |     | href     | string   | The string value is the path of the calling url.                                              |
|       | items    | list of objects |            |     |     |     | The container for the `items`.                                                                |
|       |     |            | **Name**        | **Type** |     |     |                                                                                          |
|       |     |            | id              | string   |     |     | A globally unique identifier (GUID).                                                          |
|       |     |            | name            | string   |     |     | The name of a seed-list, assigned at creation or update.                                      |
|       |     |            | description     | string   |     |     | The description of a seed-list, assigned at creation or update.                               |
|       |     |            | activeSeedCount | integer  |     |     | The count of seeds (email addresses) in the seed-list.                                        |
| 200        |     |            |            |     |     |     | Successful response but with an empty object, indicating no seed-lists for the partner appID. |

### Validation Failure Scenarios

| **HTTP Status** | **Description**                                  |
| --------------- | ------------------------------------------------ |
| 429             | API rate limit throttling is preventing success. |

## Usage

### Example Request

```url
GET /messaging/v1/email/seed-lists
```

### Example Responses

Data exists:

```json
200 OK
{
    "count": 3,
    "page": 1,
    "pageSize": 50,
    "links": {
        "self": {
            "href": "/v1/email/seed-lists"
        }
    "items":[
        {
            "id": "fb9a8b12-a088-4999-b9ce-f8cd3fe06386",
            "name": "seedList1Name1",
            "description": "A description of seedList1Name1",
            "activeSeedCount": 20
        },
        {
            "id": "3b379c49-c01a-4fb4-a5dc-13a63c735c1d",
            "name": "seedList1Name2",
            "description": "some description2",
            "activeSeedCount": 2
        },
        {
            "id": "20e173cd-12aa-45e5-bd1f-b425730f39c6",
            "name": "seedList1Name2",
            "description": "some description2",
            "activeSeedCount": 0
        }
    ]
}
```

No data exists:

```json
200 OK
{}
```

## Related Items

- [Seed-List in Rest Reference](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/routes.md#seed-list)
- [Seed-List Management API](https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_seedlist/messageSeedListManagement.md)