# Odběratelé API

> Přidávejte, upravujte a odebírejte odběratele seznamu kontaktů.

Základní URL: `https://api.emailit.com/v2`. Autentizujte se hlavičkou `Authorization: Bearer <API key>`.

## Přidání odběratele — POST /audiences/{audience_id}/subscribers

> Přidá e-mailovou adresu do seznamu kontaktů. Pokud kontakt neexistuje, Emailit ho vytvoří, a pokud se odhlásil, znovu ho přihlásí.

# Přidání odběratele

Přidá kontakt do seznamu kontaktů podle e-mailové adresy.

`POST /audiences/{audience_id}/subscribers`

Vyžaduje API klíč s oprávněním `full`. Pokud s tímto e-mailem ještě žádný kontakt neexistuje, Emailit ho vytvoří. Pokud kontakt existuje, jméno, příjmení a vlastní pole, která pošlete, přepíšou jeho aktuální hodnoty. Kontakt, který se ze seznamu odhlásil, se znovu přihlásí a odpověď je `200`; kontakt, který už přihlášený je, vrátí `409`.

Každý seznam kontaktů může mít tolik odběratelů, kolik povoluje váš tarif; nad tento počet vrátí požadavek `422` s vaším `usage`. Vyvolá `subscriber.created`, při opětovném přihlášení `subscriber.updated` a `subscriber.resubscribed`.

## Parametry v cestě

- `audience_id` (string, povinné): ID seznamu kontaktů (`aud_…`), nebo jeho název.

## Parametry v těle požadavku

- `email` (string, povinné): E-mailová adresa, kterou chcete přihlásit. Ukládá se malými písmeny.

- `first_name` (string): Jméno kontaktu.

- `last_name` (string): Příjmení kontaktu.

- `custom_fields` (object): Hodnoty [vlastních polí](/cs/docs/contacts/custom-fields/) podle klíče, například `{"company": "Analytical Engines"}`. Nahradí stávající vlastní pole kontaktu.

## Odpověď

Vrací `201` s [objektem odběratele](/cs/docs/api-reference/audiences/subscribers/get/), nebo `200`, pokud se odhlášený kontakt znovu přihlásil.

**Požadavek** `POST /audiences/{audience_id}/subscribers`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', {
  email: 'ada@example.com',
  first_name: 'Ada',
  last_name: 'Lovelace',
});
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", {
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
})
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', [
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  email: "ada@example.com",
  first_name: "Ada",
  last_name: "Lovelace"
)
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", &emailit.CreateSubscriberRequest{
  Email:     "ada@example.com",
  FirstName: "Ada",
  LastName:  "Lovelace",
})
```

**Rust**

```rust
use emailit::Emailit;
use emailit::types::CreateSubscriberParams;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  CreateSubscriberParams::new("ada@example.com")
    .with_first_name("Ada")
    .with_last_name("Lovelace")
).await?;
```

**Java**

```java
import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  SubscriberCreateParams.builder()
    .setEmail("ada@example.com")
    .setFirstName("Ada")
    .setLastName("Lovelace")
    .build()
);
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Create("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", new SubscriberCreateOptions {
  Email = "ada@example.com",
  FirstName = "Ada",
  LastName = "Lovelace",
});
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->create('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', [
  'email' => 'ada@example.com',
  'first_name' => 'Ada',
  'last_name' => 'Lovelace',
]);
```

**cURL**

```bash
curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Analytical Engines" }
  }'
```

**201**

```json
{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": true,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}
```

**404**

```json
{
  "error": "Audience not found"
}
```

**409**

```json
{
  "error": "Contact is already subscribed to this audience",
  "existing": {
    "object": "subscriber",
    "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
    "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
    "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Analytical Engines" },
    "subscribed": true,
    "subscribed_at": "2026-10-01T10:20:31.000Z",
    "unsubscribed_at": null,
    "created_at": "2026-10-01T10:20:31.000Z",
    "updated_at": "2026-10-01T10:20:31.000Z"
  }
}
```

**422**

```json
{
  "error": "Pro includes 50,000 subscribers per audience.",
  "usage": {
    "used": 50000,
    "limit": 50000,
    "plan": "pro"
  }
}
```

---
Zdroj: https://emailit.com/cs/docs/api-reference/audiences/subscribers/add/

## Načtení odběratele — GET /audiences/{audience_id}/subscribers/{id}

> Načtěte jednoho odběratele seznamu kontaktů podle ID odběratele nebo e-mailové adresy, s údaji kontaktu a stavem přihlášení.

# Načtení odběratele

Načte členství kontaktu v seznamu kontaktů.

`GET /audiences/{audience_id}/subscribers/{id}`

Vyžaduje API klíč s oprávněním `full`. Odběratel propojuje jeden [kontakt](/cs/docs/api-reference/contacts/) s jedním seznamem kontaktů. E-mail, jméno a vlastní pole patří kontaktu, kdežto `subscribed` platí jen pro tento seznam.

## Parametry v cestě

- `audience_id` (string, povinné): ID seznamu kontaktů (`aud_…`), nebo jeho název.

- `id` (string, povinné): ID odběratele (`sub_…`), nebo e-mailová adresa kontaktu zakódovaná pro URL.

## Odpověď

Vrací objekt odběratele.

- `object` (string): Vždy `subscriber`.

- `id` (string): ID odběratele.

- `audience_id` (string): ID seznamu kontaktů.

- `contact_id` (string): ID kontaktu.

- `email` (string): E-mailová adresa kontaktu.

- `first_name` (string | null): Křestní jméno kontaktu.

- `last_name` (string | null): Příjmení kontaktu.

- `custom_fields` (object | null): Hodnoty vlastních polí kontaktu.

- `subscribed` (boolean): `true`, pokud je kontakt k odběru tohoto seznamu přihlášený, `false`, pokud se odhlásil.

- `subscribed_at` (string | null): Kdy se kontakt naposledy přihlásil.

- `unsubscribed_at` (string | null): Kdy se kontakt odhlásil, nebo `null`.

- `created_at` (string): Kdy kontakt přibyl do seznamu.

- `updated_at` (string): Kdy se členství naposledy změnilo.

**Požadavek** `GET /audiences/{audience_id}/subscribers/{id}`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**Rust**

```rust
use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo").await?;
```

**Java**

```java
import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Get("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->get('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**cURL**

```bash
curl https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

**200**

```json
{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": true,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-01T10:20:31.000000Z"
}
```

**404**

```json
{
  "error": "Subscriber not found"
}
```

---
Zdroj: https://emailit.com/cs/docs/api-reference/audiences/subscribers/get/

## Úprava odběratele — POST /audiences/{audience_id}/subscribers/{id}

> Odhlaste kontakt z jednoho seznamu kontaktů nebo ho do něj znovu přihlaste, případně změňte e-mailovou adresu, jméno a vlastní pole kontaktu.

# Úprava odběratele

Změní stav odběratele v seznamu kontaktů, nebo údaje jeho kontaktu.

`POST /audiences/{audience_id}/subscribers/{id}`

Vyžaduje API klíč s oprávněním `full`. Pošlete jen pole, která chcete změnit. `subscribed` platí jen pro tento seznam kontaktů. `email`, `first_name`, `last_name` a `custom_fields` mění samotný kontakt, takže se změna projeví ve všech seznamech kontaktů, do kterých kontakt patří. Vyvolá událost `subscriber.updated`.

## Parametry v cestě

- `audience_id` (string, povinné): ID seznamu kontaktů (`aud_…`), nebo jeho název.

- `id` (string, povinné): ID odběratele (`sub_…`), nebo e-mailová adresa kontaktu zakódovaná pro URL.

## Parametry v těle požadavku

- `subscribed` (boolean): `false` kontakt z tohoto seznamu odhlásí, `true` ho znovu přihlásí. Odběratel v seznamu v obou případech zůstane.

- `email` (string): Nová e-mailová adresa kontaktu. Ukládá se malými písmeny.

- `first_name` (string): Křestní jméno kontaktu.

- `last_name` (string): Příjmení kontaktu.

- `custom_fields` (object): Hodnoty vlastních polí podle klíče. Nahradí stávající vlastní pole kontaktu.

## Odpověď

Vrací upravený [objekt odběratele](/cs/docs/api-reference/audiences/subscribers/get/). Požadavek, který neobsahuje žádné z těchto polí, vrací `400`.

**Požadavek** `POST /audiences/{audience_id}/subscribers/{id}`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscriber = await emailit.subscribers.update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', {
  first_name: 'Augusta',
});
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscriber = client.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", {
  "first_name": "Augusta",
})
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$subscriber = $emailit->subscribers()->update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', [
  'first_name' => 'Augusta',
]);
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscriber = client.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  first_name: "Augusta"
)
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscriber, err := client.Subscribers.Update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", &emailit.UpdateSubscriberRequest{
  FirstName: "Augusta",
})
```

**Rust**

```rust
use emailit::Emailit;
use emailit::types::UpdateSubscriberParams;

let emailit = Emailit::new("your_api_key");

let subscriber = emailit.subscribers.update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", UpdateSubscriberParams {
  first_name: Some("Augusta".into()),
  ..Default::default()
}).await?;
```

**Java**

```java
import com.emailit.*;
import com.emailit.params.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscriber = emailit.subscribers().update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  SubscriberUpdateParams.builder()
    .setFirstName("Augusta")
    .build()
);
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscriber = emailit.Subscribers.Update("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo", new SubscriberUpdateOptions {
  FirstName = "Augusta",
});
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$subscriber = Emailit::subscribers()->update('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo', [
  'first_name' => 'Augusta',
]);
```

**cURL**

```bash
curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"first_name": "Augusta"}'
```

**cURL**

```bash
curl -X POST https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/ada%40example.com \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"subscribed": false}'
```

**200**

```json
{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": {
    "company": "Analytical Engines"
  },
  "subscribed": false,
  "subscribed_at": "2026-10-01T10:20:31.000000Z",
  "unsubscribed_at": "2026-10-02T08:14:55.000000Z",
  "created_at": "2026-10-01T10:20:31.000000Z",
  "updated_at": "2026-10-02T08:14:55.000000Z"
}
```

**400**

```json
{
  "error": "No valid fields provided for update. Provide at least one of: email, first_name, last_name, custom_fields, subscribed"
}
```

**404**

```json
{
  "error": "Subscriber not found"
}
```

---
Zdroj: https://emailit.com/cs/docs/api-reference/audiences/subscribers/update/

## Výpis odběratelů — GET /audiences/{audience_id}/subscribers

> Vypište odběratele seznamu kontaktů od nejnovějších s vyhledáváním, filtrem přihlášení a filtry seznamu a zjistěte, kolik z limitu tarifu seznam využívá.

# Výpis odběratelů

Vrací stránku odběratelů seznamu kontaktů od nejnovějších.

`GET /audiences/{audience_id}/subscribers`

Vyžaduje API klíč s oprávněním `full`. Výpis obsahuje i kontakty, které se ze seznamu kontaktů odhlásily, pokud je neodfiltrujete pomocí `subscribed=true`.

## Parametry v cestě

- `audience_id` (string, povinné): ID seznamu kontaktů (`aud_…`), nebo jeho název.

## Parametry dotazu

- `page` (integer): Stránka, kterou chcete načíst.

- `limit` (integer): Počet odběratelů na stránce, od 1 do 100. Funguje i `per_page`.

- `subscribed` (string): `true` jen pro přihlášené kontakty, `false` jen pro odhlášené.

- `search` (string): Hledá v e-mailové adrese, křestním jménu nebo příjmení bez ohledu na velikost písmen.

- `match` (string): `all`, nebo `or`. Určuje, jak se kombinují filtry níže.

- `order` (string): Klíč filtru, podle kterého se řadí.

- `direction` (string): `asc`, nebo `desc`.

## Filtry

Filtry přidejte ve tvaru `key.condition=value`, například `email.ends_with=@acme.com`. Viz [Filtrování a řazení](/cs/docs/api-reference/filtering/).

| Klíč | Typ | Poznámky |
| --- | --- | --- |
| `email` | string | |
| `first_name` | string | |
| `last_name` | string | |
| `subscribed` | boolean | |
| `created_at` | date | Kdy kontakt přibyl do seznamu. |

Podle každého klíče lze také řadit.

## Odpověď

- `data` (object[]): [Objekty odběratelů](/cs/docs/api-reference/audiences/subscribers/get/) na této stránce.

- `next_page_url` (string | null): Cesta k další stránce, nebo `null`. Zachovává `subscribed`, ale ne vaše ostatní filtry. Viz [Stránkování](/cs/docs/api-reference/pagination/).

- `previous_page_url` (string | null): Cesta k předchozí stránce, nebo `null`.

- `usage` (object): `used` (počet odběratelů v seznamu), `limit` (nejvyšší počet, který váš tarif povoluje na jeden seznam, nebo `null`) a `plan`.

**Požadavek** `GET /audiences/{audience_id}/subscribers`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

const subscribers = await emailit.subscribers.list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

subscribers = client.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$subscribers = $emailit->subscribers()->list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

subscribers = client.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2")
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

subscribers, err := client.Subscribers.List("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", nil)
```

**Rust**

```rust
use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

let subscribers = emailit.subscribers.list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", None).await?;
```

**Java**

```java
import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

EmailitObject subscribers = emailit.subscribers().list("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

var subscribers = emailit.Subscribers.List("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2");
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

$subscribers = Emailit::subscribers()->list('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2');
```

**cURL**

```bash
curl https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

**cURL**

```bash
curl -G https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -d subscribed=true \
  -d limit=100
```

**200**

```json
{
  "data": [
    {
      "object": "subscriber",
      "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
      "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "subscribed": true,
      "subscribed_at": "2026-10-01T10:20:31.000000Z",
      "unsubscribed_at": null,
      "created_at": "2026-10-01T10:20:31.000000Z",
      "updated_at": "2026-10-01T10:20:31.000000Z"
    },
    {
      "object": "subscriber",
      "id": "sub_4KnmYprkoMRytdkm3tAHIfPW0Vh",
      "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
      "contact_id": "con_4KiXIs4xLTcJIAHnKJaLcnMZYh7",
      "email": "grace@example.com",
      "first_name": "Grace",
      "last_name": "Hopper",
      "custom_fields": null,
      "subscribed": false,
      "subscribed_at": "2026-09-28T07:55:02.000000Z",
      "unsubscribed_at": "2026-09-30T18:11:40.000000Z",
      "created_at": "2026-09-28T07:55:02.000000Z",
      "updated_at": "2026-09-30T18:11:40.000000Z"
    }
  ],
  "next_page_url": null,
  "previous_page_url": null,
  "usage": {
    "used": 2,
    "limit": 50000,
    "plan": "pro"
  }
}
```

**404**

```json
{
  "error": "Audience not found"
}
```

---
Zdroj: https://emailit.com/cs/docs/api-reference/audiences/subscribers/list/

## Smazání odběratele — DELETE /audiences/{audience_id}/subscribers/{id}

> Odebere kontakt ze seznamu kontaktů. Kontakt i jeho členství v ostatních seznamech ve vašem workspace zůstanou.

# Smazání odběratele

Odebere kontakt ze seznamu kontaktů.

`DELETE /audiences/{audience_id}/subscribers/{id}`

Vyžaduje API klíč s oprávněním `full`. Samotný [kontakt](/cs/docs/api-reference/contacts/) se nesmaže a zůstane ve svých ostatních seznamech. Pokud si chcete ponechat záznam o tom, že se někdo odhlásil, raději ho [odhlaste](/cs/docs/api-reference/audiences/subscribers/update/) pomocí `subscribed: false`. Vyvolá událost `subscriber.deleted`.

## Parametry v cestě

- `audience_id` (string, povinné): ID seznamu kontaktů (`aud_…`), nebo jeho název.

- `id` (string, povinné): ID odběratele (`sub_…`), nebo e-mailová adresa kontaktu zakódovaná do URL.

## Odpověď

- `object` (string): Vždy `subscriber`.

- `id` (string): ID smazaného odběratele.

- `audience_id` (string): ID seznamu kontaktů.

- `contact_id` (string): ID kontaktu.

- `email` (string): E-mailová adresa kontaktu.

- `deleted` (boolean): Vždy `true`.

**Požadavek** `DELETE /audiences/{audience_id}/subscribers/{id}`

**Node.js**

```javascript
import { Emailit } from '@emailit/node';
const emailit = new Emailit('your_api_key');

await emailit.subscribers.delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**Python**

```python
from emailit import EmailitClient
client = EmailitClient("your_api_key")

client.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**PHP**

```php
$emailit = Emailit::client('your_api_key');

$emailit->subscribers()->delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**Ruby**

```ruby
require "emailit"
client = Emailit::EmailitClient.new("your_api_key")

client.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**Go**

```go
import "github.com/emailit/emailit-go/v2"
client := emailit.NewClient("your_api_key")

err := client.Subscribers.Delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo")
```

**Rust**

```rust
use emailit::Emailit;

let emailit = Emailit::new("your_api_key");

emailit.subscribers.delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo").await?;
```

**Java**

```java
import com.emailit.*;

EmailitClient emailit = new EmailitClient("your_api_key");

emailit.subscribers().delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");
```

**.NET**

```csharp
using Emailit;

var emailit = new EmailitClient("your_api_key");

emailit.Subscribers.Delete("aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2", "sub_4KECYl5AwXEy8ezswYRhuddttxo");
```

**Laravel**

```php
use Emailit\Laravel\Facades\Emailit;

Emailit::subscribers()->delete('aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2', 'sub_4KECYl5AwXEy8ezswYRhuddttxo');
```

**cURL**

```bash
curl -X DELETE https://api.emailit.com/v2/audiences/aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2/subscribers/sub_4KECYl5AwXEy8ezswYRhuddttxo \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

**200**

```json
{
  "object": "subscriber",
  "id": "sub_4KECYl5AwXEy8ezswYRhuddttxo",
  "audience_id": "aud_4KbFmQPy1feMCGAY8F8pAhiZ1u2",
  "contact_id": "con_4K9kQdrXth7am0TPKvPrR5yd2oo",
  "email": "ada@example.com",
  "deleted": true
}
```

**404**

```json
{
  "error": "Subscriber not found"
}
```

---
Zdroj: https://emailit.com/cs/docs/api-reference/audiences/subscribers/delete/