---
title: "Fetch a paginated list of contacts for a marketing list"
method: GET
path: "/api/list/{listId}/contacts"
tags: ["Records Management"]
---

# Fetch a paginated list of contacts for a marketing list

`GET /api/list/{listId}/contacts`

## Request

- Base URL: `https://api.reallysimplesystems.com`
- URL: `https://api.reallysimplesystems.com/api/list/{listId}/contacts`
- Auth: HTTP bearer

Retrieves a paginated list of records for the specified object type. Supports filtering parameters.

## Response `200`

Successful response containing the paginated list of contacts

- object
  - `data` object
    - `metadata` object
      - `url` string
      - `object_type` string
      - `total_count` integer
      - `has_more` boolean
    - `list` object[]
      - `metadata` object
        - `url` string
        - `list_url` string
        - `parent` string
        - `object_type` string
        - `record_type` string
      - `record` object
        - `id` integer
        - `first` string
        - `last` string
        - `email` string
    - `links` object
      - `first` string
      - `last` string
      - `prev` string, nullable
      - `next` string
    - `meta` object
      - `current_page` integer
      - `from` integer
      - `last_page` integer
      - `path` string
      - `per_page` integer
      - `to` integer
      - `total` integer

## Other responses

- `404`: The marketing list could not be found

---

[API](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation.md) · [All operations](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/reallysimplesystems/apis/crm-api-documentation/revisions/eb046f87bd56?raw)