> For the complete documentation index, see [llms.txt](https://experience-crm.gitbook.io/experience-crm-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://experience-crm.gitbook.io/experience-crm-api/mailing-list/unsubscribe-opt-out/get-unsubscribed-customer.md).

# Get unsubscribed customer

### Request 

<mark style="color:green;">**GET**</mark> &#x20;

{% code overflow="wrap" %}

```
https://interface.experience-hotel.com/api/xp-unsubscribe/retrieve-opt-out?since=2024-03-13
```

{% endcode %}

| Param  | Format     | Required |
| ------ | ---------- | -------- |
| since  | YYYY-MM-DD | Required |
| cursor | token      | optional |

Return a list of 250 customers.&#x20;

**Pagination**&#x20;

If the query has more than 250 customers, you will find a `next_page_url` with a URL containing a cursor parameter.&#x20;

You can use this "cursor" parameter in your request to retrieve the next page.&#x20;

{% code overflow="wrap" %}

```url
https://interface.experience-hotel.com/api/xp-unsubscribe/retrieve-opt-out?since=2024-03-13&cursor=eyJjdXN0b21lcl9jb25maWcuaWQiOjE0NDI5NTE5LCJfcG9pbnRzVG9OZXh0SXRlbXM468qds4f
```

{% endcode %}

### Response

Status Code 200 OK

{% code title="JSON" overflow="wrap" %}

```json
{
    "recipients": [
        {
            "email": "email@test.com",
            "mail_ban": "2022-01-01 10:10:09"
        },
        {
            "email": "email2@test.com",
            "mail_ban": "2022-01-01 10:35:08",
            "marketing_decline": "2021-12-26 15:04:06",
            "sms_ban": "2021-06-03 10:15:07"
        },
        {
            "email": "email3@test.com",
            "mail_ban": "2022-01-01 10:27:38",
            "marketing_decline": "2021-06-11 19:43:31"
        },
        {
            "email": "email4@test.com",
            "mail_ban": "2022-01-01 11:00:56",
            "marketing_decline": "2021-08-31 15:28:19"
        }
    ],
    "next_page_url": "https://interface.experience-hotel.com/api/xp-unsubscribe/retrieve-opt-out?cursor=eyJjdXN0b21lcl9jb25maWcuaWQiOjE0NDI5NTE5LCJfcG9pbnRzVG9OZXh0SXRlbXM468qds4f"
}
```

{% endcode %}