> ## Documentation Index
> Fetch the complete documentation index at: https://help.kajabi.com/llms.txt
> Use this file to discover all available pages before exploring further.

<AgentInstructions>

## Submitting Feedback

If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:

POST https://help.kajabi.com/feedback

```json
{
  "path": "/api-reference/contacts/list-contacts",
  "feedback": "Description of the issue"
}
```

Only submit feedback when you have something specific and actionable to report.

</AgentInstructions>

# List contacts

> List of contacts, we recommended filtering by site.

## Filtering
Use the `filter[site_id]` parameter to filter contacts by site:

### Get contacts for site with ID 123
* `GET /v1/contacts?filter[site_id]=123`

Response will include only contacts for the specified site
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "John Smith",
      "email": "john@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Search Filter
Use the `filter[search]` parameter along with `filter[site_id]` to search contacts by name or email:

### Search for contacts containing "smith" in site with ID 123
* `GET /v1/contacts?filter[site_id]=123&filter[search]=smith`

Response will include only matching contacts for the specified site
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "John Smith",
      "email": "smith.john@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Search
Use the `filter[search]` parameter along with `filter[site_id]` to search contacts.

### Search for contacts containing "smith" in site with ID 123
* `GET /v1/contacts?filter[site_id]=123&filter[search]=smith`

Response will include matching contacts
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "John Smith",
      "email": "smith.john@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Using Pagination with Site Filter
Use the `filter[site_id]` parameter along with pagination parameters `page[number]` and `page[size]` to get paginated results for a specific site:

### Get page 2 of contacts from site with ID 123, with 10 items per page
* `GET /v1/contacts?filter[site_id]=123&page[number]=2&page[size]=10`

Response will include paginated contacts for the specified site along with pagination metadata
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "John Smith",
      "email": "smith.john@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }],
  "links": {
    "self": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=2&page[size]=10",
    "first": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=1&page[size]=10",
    "prev": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=1&page[size]=10",
    "next": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=3&page[size]=10",
    "last": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=5&page[size]=10"
  },
  "meta": {
    "total_pages": 5,
    "total_count": 50,
    "current_page": 2
  }
}
```
## Using Sort with Site Filter
* The default Sorting is by created_at in descending order (newest first)

Sorting by created_at in ascending order (oldest first)
* `GET /v1/contacts?filter[site_id]=123&sort=created_at`

Use the `sort` parameter along with `filter[site_id]` to get sorted results for a specific site:
### Get contacts from site with ID 123, sorted by name in ascending order
* `GET /v1/contacts?filter[site_id]=123&sort=name`
### Get contacts from site with ID 123, sorted by email in descending order
* `GET /v1/contacts?filter[site_id]=123&sort=-email`

Response will include sorted contacts for the specified site
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "Alice Smith",
      "email": "alice@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Using Sparse Fields with Site Filter
Use the `fields[contacts]` parameter along with `filter[site_id]` to get specific fields for contacts in a site:
### Get only name and email fields for contacts from site with ID 123
* `GET /v1/contacts?filter[site_id]=123&fields[contacts]=name,email`

Response will include only requested fields for contacts in the specified site
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "Alice Smith",
      "email": "alice@example.com"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Filtering by Site and Offer
Use the `filter[site_id]` parameter along with `filter[has_offer_id]` to get contacts who have been granted a specific offer

### Get contacts from site with ID 123 who have been granted offer with ID 789
* `GET /v1/contacts?filter[site_id]=123&filter[has_offer_id]=789`

Response will include only contacts from the specified site who have been granted the offer
```json
{
  "data": [{
    "id": "456",
    "type": "contacts",
    "attributes": {
      "name": "Alice Smith",
      "email": "alice@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```

## Filtering by Site and Tag
Use the `filter[site_id]` parameter along with `filter[has_tag_id]` to get contacts who have a specific tag

### Get contacts from site with ID 123 who have tag with ID 456
* `GET /v1/contacts?filter[site_id]=123&filter[has_tag_id]=456`

Response will include only contacts from the specified site who have the tag
```json
{
  "data": [{
    "id": "789",
    "type": "contacts",
    "attributes": {
      "name": "Bob Jones",
      "email": "bob@example.com",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    },
    "relationships": {
      "site": {
        "data": {
          "id": "123",
          "type": "sites"
        }
      }
    }
  }]
}
```
## Using Multiple Parameters Together
You can combine multiple parameters to filter, search, paginate and format the response:

### Get paginated contacts from site 123 with tag 456, searching for "smith", using indexed data and sparse fields
* `GET /v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email`

Response will include paginated contacts matching all filters with only requested fields
```json
{
  "data": [{
    "id": "789",
    "type": "contacts",
    "attributes": {
      "name": "John Smith",
      "email": "smith.john@example.com"
    }
  }],
  "links": {
    "self": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email",
    "first": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email",
    "prev": null,
    "next": null,
    "last": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email"
  },
  "meta": {
    "total_pages": 1,
    "total_count": 1,
    "current_page": 1
  }
}
```




## OpenAPI

````yaml /openapi.yaml get /v1/contacts
openapi: 3.1.1
info:
  title: Kajabi API V1
  version: 1.0.1
  description: >
    ## Public API

    * Server URL `https://api.kajabi.com`

    * Endpoint paths are prefixed with `/v1`

    * Version endpoint `GET https://api.kajabi.com/v1/version`

    * See the [Developers Site](https://developers.kajabi.com) for documentation
    and examples.

    * Try the demo [Postman
    collection](https://www.postman.com/kajabi-apis/beta-public-api-demo/collection/fg4iyaz/kajabi-public-api-v1)

    ## API Keys

    * Your API `client_id` and `client_secret` are available on the [User API
    Keys](https://app.kajabi.com/admin/settings/security) section of the Kajabi
    Admin Portal.
      * Custom API Keys can be created with specific permissions.
      * Click the "Create User API Key" button, enter a name (e.g. "My project"), select the user and permissions, and click "Create".
      * For security purposes, you may "Delete" or "Rotate" the api credentials at any time; which will invalidate any access tokens granted with the credentials.
    ## Video Walkthroughs

    *
    [Capabilities](https://drive.google.com/file/d/1Puc9B2sSdA-RQb7YMxmUXg4FVoEXytoc/view?usp=sharing)

    * [Getting
    Started](https://drive.google.com/file/d/1hbGRShkxven_QMWvgYrerHKURbcZrnvJ/view?usp=sharing)

    * [Error
    Examples](https://drive.google.com/file/d/1i0wQK71I1jpaZVsxYwsn62gVj40S_E7Y/view?usp=sharing)

    * [External Contact
    Form](https://drive.google.com/file/d/1HqpULXvan5TOK3LvM7nILCuCkCaX0kFT/view?usp=sharing)
  contact:
    email: support@kajabi.com
    name: Support
    url: >-
      https://help.kajabi.com/hc/en-us/articles/4404549690523-How-to-Get-Help-From-Kajabi-Live-Agents
  license:
    name: Apache 2.0
    url: http://www.apache.org/licenses/LICENSE-2.0.html
servers:
  - url: https://api.kajabi.com
    description: Production
security: []
paths:
  /v1/contacts:
    get:
      tags:
        - Contacts
      summary: List contacts
      description: >
        List of contacts, we recommended filtering by site.


        ## Filtering

        Use the `filter[site_id]` parameter to filter contacts by site:


        ### Get contacts for site with ID 123

        * `GET /v1/contacts?filter[site_id]=123`


        Response will include only contacts for the specified site

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "John Smith",
              "email": "john@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Search Filter

        Use the `filter[search]` parameter along with `filter[site_id]` to
        search contacts by name or email:


        ### Search for contacts containing "smith" in site with ID 123

        * `GET /v1/contacts?filter[site_id]=123&filter[search]=smith`


        Response will include only matching contacts for the specified site

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "John Smith",
              "email": "smith.john@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Search

        Use the `filter[search]` parameter along with `filter[site_id]` to
        search contacts.


        ### Search for contacts containing "smith" in site with ID 123

        * `GET /v1/contacts?filter[site_id]=123&filter[search]=smith`


        Response will include matching contacts

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "John Smith",
              "email": "smith.john@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Using Pagination with Site Filter

        Use the `filter[site_id]` parameter along with pagination parameters
        `page[number]` and `page[size]` to get paginated results for a specific
        site:


        ### Get page 2 of contacts from site with ID 123, with 10 items per page

        * `GET /v1/contacts?filter[site_id]=123&page[number]=2&page[size]=10`


        Response will include paginated contacts for the specified site along
        with pagination metadata

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "John Smith",
              "email": "smith.john@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }],
          "links": {
            "self": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=2&page[size]=10",
            "first": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=1&page[size]=10",
            "prev": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=1&page[size]=10",
            "next": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=3&page[size]=10",
            "last": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&page[number]=5&page[size]=10"
          },
          "meta": {
            "total_pages": 5,
            "total_count": 50,
            "current_page": 2
          }
        }

        ```

        ## Using Sort with Site Filter

        * The default Sorting is by created_at in descending order (newest
        first)


        Sorting by created_at in ascending order (oldest first)

        * `GET /v1/contacts?filter[site_id]=123&sort=created_at`


        Use the `sort` parameter along with `filter[site_id]` to get sorted
        results for a specific site:

        ### Get contacts from site with ID 123, sorted by name in ascending
        order

        * `GET /v1/contacts?filter[site_id]=123&sort=name`

        ### Get contacts from site with ID 123, sorted by email in descending
        order

        * `GET /v1/contacts?filter[site_id]=123&sort=-email`


        Response will include sorted contacts for the specified site

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "Alice Smith",
              "email": "alice@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Using Sparse Fields with Site Filter

        Use the `fields[contacts]` parameter along with `filter[site_id]` to get
        specific fields for contacts in a site:

        ### Get only name and email fields for contacts from site with ID 123

        * `GET /v1/contacts?filter[site_id]=123&fields[contacts]=name,email`


        Response will include only requested fields for contacts in the
        specified site

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "Alice Smith",
              "email": "alice@example.com"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Filtering by Site and Offer

        Use the `filter[site_id]` parameter along with `filter[has_offer_id]` to
        get contacts who have been granted a specific offer


        ### Get contacts from site with ID 123 who have been granted offer with
        ID 789

        * `GET /v1/contacts?filter[site_id]=123&filter[has_offer_id]=789`


        Response will include only contacts from the specified site who have
        been granted the offer

        ```json

        {
          "data": [{
            "id": "456",
            "type": "contacts",
            "attributes": {
              "name": "Alice Smith",
              "email": "alice@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```


        ## Filtering by Site and Tag

        Use the `filter[site_id]` parameter along with `filter[has_tag_id]` to
        get contacts who have a specific tag


        ### Get contacts from site with ID 123 who have tag with ID 456

        * `GET /v1/contacts?filter[site_id]=123&filter[has_tag_id]=456`


        Response will include only contacts from the specified site who have the
        tag

        ```json

        {
          "data": [{
            "id": "789",
            "type": "contacts",
            "attributes": {
              "name": "Bob Jones",
              "email": "bob@example.com",
              "created_at": "2024-01-15T10:30:00Z",
              "updated_at": "2024-01-15T10:30:00Z"
            },
            "relationships": {
              "site": {
                "data": {
                  "id": "123",
                  "type": "sites"
                }
              }
            }
          }]
        }

        ```

        ## Using Multiple Parameters Together

        You can combine multiple parameters to filter, search, paginate and
        format the response:


        ### Get paginated contacts from site 123 with tag 456, searching for
        "smith", using indexed data and sparse fields

        * `GET
        /v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email`


        Response will include paginated contacts matching all filters with only
        requested fields

        ```json

        {
          "data": [{
            "id": "789",
            "type": "contacts",
            "attributes": {
              "name": "John Smith",
              "email": "smith.john@example.com"
            }
          }],
          "links": {
            "self": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email",
            "first": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email",
            "prev": null,
            "next": null,
            "last": "https://api.kajabi.com/v1/contacts?filter[site_id]=123&filter[has_tag_id]=456&filter[search]=smith&=true&page[number]=1&page[size]=10&fields[contacts]=name,email"
          },
          "meta": {
            "total_pages": 1,
            "total_count": 1,
            "current_page": 1
          }
        }

        ```
      parameters:
        - name: sort
          in: query
          required: false
          description: >-
            Sort order, use: name, email, created_at, for descending order use
            '-' e.g. &sort=-name
          schema:
            type: string
        - name: page[number]
          in: query
          required: false
          schema:
            type: number
        - name: page[size]
          in: query
          required: false
          description: Number of documents
          schema:
            type: number
        - name: fields[contacts]
          in: query
          required: false
          description: >-
            Sparse fields, use: name, email for example
            ?fields[contacts]=name,email
          schema:
            type: string
        - name: filter[site_id]
          in: query
          required: false
          description: >-
            It is recommended to always filter by site_id, for example
            ?filter[site_id]=111. This param is required when the account has
            multiple sites
          schema:
            type: string
        - name: filter[search]
          in: query
          required: false
          description: >-
            Filter with fuzzy search of name/email, for example
            ?filter[search]=alexa
          schema:
            type: string
        - name: filter[created_in_last]
          in: query
          required: false
          description: >-
            Filter contacts created in the last N days, e.g.
            ?filter[created_in_last]=30
          schema:
            type: string
        - name: filter[not_created_in_last]
          in: query
          required: false
          description: Filter contacts not created in the last N days
          schema:
            type: string
        - name: filter[is_hidden]
          in: query
          required: false
          description: Filter hidden contacts
          schema:
            type: string
        - name: filter[joined_in_last]
          in: query
          required: false
          description: Filter contacts who joined in the last N days
          schema:
            type: string
        - name: filter[active_in_last]
          in: query
          required: false
          description: Filter contacts active in the last N days
          schema:
            type: string
        - name: filter[inactive_in_last]
          in: query
          required: false
          description: Filter contacts inactive in the last N days
          schema:
            type: string
        - name: filter[name_contains]
          in: query
          required: false
          description: Filter contacts whose name contains the given value
          schema:
            type: string
        - name: filter[email_contains]
          in: query
          required: false
          description: Filter contacts whose email contains the given value
          schema:
            type: string
        - name: filter[phone_number_contains]
          in: query
          required: false
          description: Filter contacts whose phone number contains the given value
          schema:
            type: string
        - name: filter[address_line_1_contains]
          in: query
          required: false
          description: Filter contacts whose address line 1 contains the given value
          schema:
            type: string
        - name: filter[address_line_2_contains]
          in: query
          required: false
          description: Filter contacts whose address line 2 contains the given value
          schema:
            type: string
        - name: filter[address_city_contains]
          in: query
          required: false
          description: Filter contacts whose city contains the given value
          schema:
            type: string
        - name: filter[address_state_contains]
          in: query
          required: false
          description: Filter contacts whose state contains the given value
          schema:
            type: string
        - name: filter[address_country_contains]
          in: query
          required: false
          description: Filter contacts whose country contains the given value
          schema:
            type: string
        - name: filter[address_zip_contains]
          in: query
          required: false
          description: Filter contacts whose zip code contains the given value
          schema:
            type: string
        - name: filter[has_tag_id]
          in: query
          required: false
          description: Filter contacts with a specific tag ID
          schema:
            type: string
        - name: filter[has_all_tag_id]
          in: query
          required: false
          description: Filter contacts with all specified tag IDs
          schema:
            type: string
        - name: filter[has_no_tag_id]
          in: query
          required: false
          description: Filter contacts without the specified tag ID
          schema:
            type: string
        - name: filter[subscribed]
          in: query
          required: false
          description: Filter subscribed contacts
          schema:
            type: string
        - name: filter[has_offer_id]
          in: query
          required: false
          description: Filter contacts with a specific offer ID
          schema:
            type: string
        - name: filter[has_no_offer_id]
          in: query
          required: false
          description: Filter contacts without the specified offer ID
          schema:
            type: string
        - name: filter[used_coupon_code]
          in: query
          required: false
          description: Filter contacts who used a specific coupon code
          schema:
            type: string
        - name: filter[submitted_form_id]
          in: query
          required: false
          description: Filter contacts who submitted a specific form ID
          schema:
            type: string
        - name: filter[no_submitted_form_id]
          in: query
          required: false
          description: Filter contacts who have not submitted the specified form ID
          schema:
            type: string
        - name: filter[registered_event_id]
          in: query
          required: false
          description: Filter contacts who registered for a specific event ID
          schema:
            type: string
        - name: filter[not_registered_event_id]
          in: query
          required: false
          description: Filter contacts who have not registered for the specified event ID
          schema:
            type: string
        - name: filter[completed_assessment_id]
          in: query
          required: false
          description: Filter contacts who completed a specific assessment ID
          schema:
            type: string
        - name: filter[passed_assessment_id]
          in: query
          required: false
          description: Filter contacts who passed a specific assessment ID
          schema:
            type: string
        - name: filter[failed_assessment_id]
          in: query
          required: false
          description: Filter contacts who failed a specific assessment ID
          schema:
            type: string
        - name: filter[net_revenue_equal_to]
          in: query
          required: false
          description: Filter contacts whose net revenue equals the given value
          schema:
            type: string
        - name: filter[net_revenue_greater_than]
          in: query
          required: false
          description: Filter contacts whose net revenue is greater than the given value
          schema:
            type: string
        - name: filter[net_revenue_less_than]
          in: query
          required: false
          description: Filter contacts whose net revenue is less than the given value
          schema:
            type: string
        - name: filter[subscribed_in_last]
          in: query
          required: false
          description: Filter contacts subscribed in the last N days
          schema:
            type: string
        - name: filter[unsubscribed_in_last]
          in: query
          required: false
          description: Filter contacts unsubscribed in the last N days
          schema:
            type: string
        - name: filter[never_subscribed]
          in: query
          required: false
          description: Filter contacts who have never subscribed
          schema:
            type: string
        - name: filter[sent_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who were sent a specific email broadcast ID
          schema:
            type: string
        - name: filter[no_sent_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who were not sent the specified email broadcast ID
          schema:
            type: string
        - name: filter[no_sent_email_broadcast_ids]
          in: query
          required: false
          description: >-
            Filter contacts who were not sent any of the specified email
            broadcast IDs
          schema:
            type: string
        - name: filter[no_delivered_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who did not receive the specified email broadcast ID
          schema:
            type: string
        - name: filter[opened_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who opened a specific email broadcast ID
          schema:
            type: string
        - name: filter[no_opened_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who did not open the specified email broadcast ID
          schema:
            type: string
        - name: filter[clicked_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who clicked a specific email broadcast ID
          schema:
            type: string
        - name: filter[no_clicked_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who did not click the specified email broadcast ID
          schema:
            type: string
        - name: filter[bounced_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who bounced a specific email broadcast ID
          schema:
            type: string
        - name: filter[no_bounced_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who did not bounce the specified email broadcast ID
          schema:
            type: string
        - name: filter[dropped_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who dropped a specific email broadcast ID
          schema:
            type: string
        - name: filter[no_dropped_email_broadcast_id]
          in: query
          required: false
          description: Filter contacts who did not drop the specified email broadcast ID
          schema:
            type: string
        - name: filter[opened_email_in_last]
          in: query
          required: false
          description: Filter contacts who opened an email in the last N days
          schema:
            type: string
        - name: filter[not_opened_email_in_last]
          in: query
          required: false
          description: Filter contacts who did not open an email in the last N days
          schema:
            type: string
        - name: filter[delivered_email_in_last]
          in: query
          required: false
          description: Filter contacts who were delivered an email in the last N days
          schema:
            type: string
        - name: filter[not_delivered_email_in_last]
          in: query
          required: false
          description: Filter contacts who were not delivered an email in the last N days
          schema:
            type: string
        - name: filter[clicked_email_in_last]
          in: query
          required: false
          description: Filter contacts who clicked an email in the last N days
          schema:
            type: string
        - name: filter[not_clicked_email_in_last]
          in: query
          required: false
          description: Filter contacts who did not click an email in the last N days
          schema:
            type: string
        - name: filter[is_hard_bouncing]
          in: query
          required: false
          description: Filter contacts that are hard bouncing
          schema:
            type: string
        - name: filter[bounced_in_last]
          in: query
          required: false
          description: Filter contacts who bounced in the last N days
          schema:
            type: string
        - name: filter[complained_in_last]
          in: query
          required: false
          description: Filter contacts who complained in the last N days
          schema:
            type: string
        - name: filter[manually_unsubscribed_in_last]
          in: query
          required: false
          description: Filter contacts manually unsubscribed in the last N days
          schema:
            type: string
        - name: filter[opted_out_in_last]
          in: query
          required: false
          description: Filter contacts who opted out in the last N days
          schema:
            type: string
        - name: filter[healthy_contacts_with_open_data]
          in: query
          required: false
          description: Filter healthy contacts with open data
          schema:
            type: string
        - name: filter[passive_contacts_with_open_data]
          in: query
          required: false
          description: Filter passive contacts with open data
          schema:
            type: string
        - name: filter[unengaged_contacts_with_open_data]
          in: query
          required: false
          description: Filter unengaged contacts with open data
          schema:
            type: string
        - name: filter[inactive_contacts_with_open_data]
          in: query
          required: false
          description: Filter inactive contacts with open data
          schema:
            type: string
        - name: filter[subscribed_newsletter_id]
          in: query
          required: false
          description: Filter contacts subscribed to a specific newsletter ID
          schema:
            type: string
        - name: filter[unsubscribed_newsletter_id]
          in: query
          required: false
          description: Filter contacts unsubscribed from a specific newsletter ID
          schema:
            type: string
        - name: filter[is_suppressed]
          in: query
          required: false
          description: Filter suppressed contacts
          schema:
            type: string
        - name: filter[mobile_phone_number_contains]
          in: query
          required: false
          description: Filter contacts whose mobile phone number contains the given value
          schema:
            type: string
        - name: filter[subscribed_email_sequence_id]
          in: query
          required: false
          description: Filter contacts subscribed to a specific email sequence ID
          schema:
            type: string
        - name: filter[not_subscribed_email_sequence_id]
          in: query
          required: false
          description: Filter contacts not subscribed to a specific email sequence ID
          schema:
            type: string
      responses:
        '200':
          description: Success, list search results
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/contacts_index_response'
        '401':
          description: Unauthorized, Authorization header is missing or invalid
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_unauthorized'
        '403':
          description: Forbidden, insufficient permission to access the resource
          content:
            application/vnd.api+json:
              schema:
                $ref: '#/components/schemas/errors_forbidden'
      security:
        - Bearer: []
components:
  schemas:
    contacts_index_response:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              type:
                type: string
              attributes:
                $ref: '#/components/schemas/contacts_attributes'
              relationships:
                type: object
                properties:
                  customer:
                    type: object
                    nullable: true
                    properties:
                      data:
                        $ref: '#/components/schemas/resource_identifier'
                  offers:
                    type: object
                    nullable: true
                    properties:
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                  site:
                    type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/resource_identifier'
                  tags:
                    type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/resource_identifiers'
              links:
                type: object
                properties:
                  customer:
                    type: string
        links:
          type: object
          properties:
            self:
              type: string
            current:
              type: string
    errors_unauthorized:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/errors_attributes'
    errors_forbidden:
      type: object
      properties:
        errors:
          type: array
          items:
            $ref: '#/components/schemas/errors_attributes'
    contacts_attributes:
      type: object
      properties:
        name:
          type: string
        email:
          type: string
        phone_number:
          type:
            - string
            - 'null'
        business_number:
          type:
            - string
            - 'null'
        subscribed:
          type: boolean
        address_line_1:
          type:
            - string
            - 'null'
        address_line_2:
          type:
            - string
            - 'null'
        address_city:
          type:
            - string
            - 'null'
        address_state:
          type:
            - string
            - 'null'
        address_country:
          type:
            - string
            - 'null'
        external_user_id:
          type: string
          nullable: true
          description: Supported once contact is granted an offer or makes a purchase
        address_zip:
          type:
            - string
            - 'null'
        custom_1:
          type: string
          nullable: true
          description: Support depends on custom fields of a site
        custom_2:
          type: string
          nullable: true
          description: Support depends on custom fields of a site
        custom_3:
          type: string
          nullable: true
          description: Support depends on custom fields of a site
        created_at:
          type: string
          format: date-time
          readOnly: true
          description: ISO 8601 date-time, read only
        updated_at:
          type: string
          format: date-time
          readOnly: true
          description: ISO 8601 date-time, read only
    resource_identifier:
      type: object
      properties:
        id:
          type: string
        type:
          type: string
      required:
        - id
        - type
    resource_identifiers:
      type: array
      items:
        $ref: '#/components/schemas/resource_identifier'
    errors_attributes:
      type: object
      properties:
        status:
          type: string
        source:
          type: object
          nullable: true
          properties:
            pointer:
              type: string
        title:
          type: string
        detail:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````