---
title: "List iMessage senders"
method: GET
path: "/v1/imessage/senders"
tags: ["iMessage"]
---

# List iMessage senders

`GET /v1/imessage/senders`

Lists the iMessage senders registered across your accessible profiles.

## Response `200`

Registered iMessage senders

- object
  - `senders` ImessageSender[]
    - `id` string — Account id (use it with the inbox endpoints' accountId)
    - `platform` 'imessage'
    - `sender` string — The sender handle (E.164 phone or email)
    - `optInLink` string, nullable — imessage:// deep link that opens Messages on this sender with a prefilled text. Share it so contacts message you first (Apple only lets a sender reach contacts who wrote to it first).
    - `displayName` string
    - `profileId` string, nullable
    - `provider` string — Delivery provider backing this sender (e.g. loopmessage)
    - `senderVerified` boolean — Whether the provider confirmed the sender as active at registration time
    - `isActive` boolean

## Other responses

- `401` — Unauthorized

## Changes

- **2026-09-21** `339f59df69dd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/imessage/senders/get.md)

---

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