Kalo te dokumentacioni
API

Listo marrësit e një transmetimi

Të gjithë ata që u shkoi transmetimi, një rresht për kopje, të renditur sipas adresës: id-ja e kopjes, statusi i saj, kur u dërgua dhe u dorëzua, nëse u kthye ose u raportua si spam, sa herë u hap dhe u klikua, dhe nëse personi u çregjistrua pasi ai u nis.

GETapi.openemail.uk/broadcasts/{id}/recipients

Ekzekuton thirrjen reale kundrejt hapësirës suaj të punës, me çelësin tuaj.

GET /broadcasts/{id}/recipients

Të gjithë ata që u shkoi transmetimi, një rresht për kopje, të renditur sipas adresës: id-ja e kopjes, statusi i saj, kur u dërgua dhe u dorëzua, nëse u kthye ose u raportua si spam, sa herë u hap dhe u klikua, dhe nëse personi u çregjistrua pasi ai u nis.

Parametrat

idstringe detyrueshme
Në shteg. Një id `brd_` nga `POST /broadcasts` ose `GET /broadcasts`.
filterstring
Mban një grup: `pending` (ende në radhë ose duke u dërguar), `sent`, `delivered`, `opened`, `not_opened` (të dërguara dhe kurrë të hapura), `clicked`, `bounced`, `complained`, `failed` (të dështuara ose të anuluara) ose `unsubscribed`.
qstring
Kërkon në adresë dhe emër, pa dallim mes shkronjave të mëdha dhe të vogla. Deri në 200 karaktere.
limitinteger
Rreshta për faqe, nga 1 deri në 200. Parazgjedhja është 50.
cursorstring
`nextCursor` i faqes së mëparshme, i kthyer ashtu siç erdhi, me të njëjtat `filter` dhe `q`. Ai mban vendin ku ishte rreshti i fundit, ndaj një rresht që ndryshon mes faqeve nuk e prish kurrë kalimin.

Shembull

Kërkon emails:read. Përgjigjja është një faqe me rreshta broadcast_recipient.

curl
curl "$OE/broadcasts/brd_5a8c1e3f7b2d94a06c8e1f3b/recipients?filter=opened&limit=50" -H "$AUTH"
Përgjigje
{  "object": "list",  "data": [    {      "object": "broadcast_recipient",      "emailId": "msg_01dad25067bc4dac966d515d",      "contactId": "6f1c2a8e-3b4d-4e9f-a1c7-2d5e8b0f9a34",      "email": "[email protected]",      "name": "Ada Lovelace",      "status": "sent",      "sentAt": "2026-09-23T12:00:09.000Z",      "deliveredAt": "2026-09-23T12:00:11.000Z",      "bouncedAt": null,      "complainedAt": null,      "failure": null,      "opens": 3,      "firstOpenAt": "2026-09-23T12:14:30.000Z",      "clicks": 1,      "firstClickAt": "2026-09-23T12:15:02.000Z",      "unsubscribedAt": null    }  ],  "hasMore": true,  "nextCursor": "WyJhZGFAZXhhbXBsZS5jb20iLCJtc2dfMDFkYWQyNTA2N2JjNGRhYzk2NmQ1MTVkIl0"}

Hapjet dhe klikimet lënë jashtë proxy-t e imazheve dhe skanerët e lidhjeve, dhe mbeten 0 kur transmetimi u dërgua me gjurmimin të fikur.

status është gjendja e kopjes në regjistrin e dërgimeve: queued, scheduled, sending, sent, failed ose cancelled. deliveredAt, bouncedAt dhe complainedAt janë email.delivered, email.bounced dhe email.complained i parë për të, dhe failure tregon pse dështoi një kopje.

unsubscribedAt është koha kur personi u çregjistrua nga një prej audiencave të transmetimit pasi ai u nis, përmes lidhjes së tij ose ndryshe. contactId është null kur kontakti është fshirë që atëherë.

emailId është id-ja msg_ e kopjes. GET /broadcasts/{id}/recipients/{emailId} e lexon me përmbajtjen e saj, dhe GET /emails/{id} e lexon si email të dërguar.

Refuzimet

StatusiKodiKur
400invalid_cursorTe lista e marrësve, një cursor që ajo listë nuk e ka dhënë.
403insufficient_scopeÇelësi nuk ka emails:read.
404broadcast_not_foundID-ja nuk emërton asnjë transmetim në këtë hapësirë pune, ose çelësi është i kufizuar në adresa ose domene të caktuara dhe transmetimi u dërgua nga një që ai nuk e mban.
404recipient_not_foundTe GET /broadcasts/{id}/recipients/{emailId}, një emailId që nuk është kopje e këtij transmetimi.