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

# List iMessage sandbox contacts

`GET /v1/imessage/sandbox/contacts`

## Request

- Base URL: `https://zernio.com/api`
- URL: `https://zernio.com/api/v1/imessage/sandbox/contacts`
- Auth: HTTP bearer

The shared sandbox line and your sandbox contacts. The sandbox lets you test iMessage without ordering a sender: add your own phone or Apple ID email, send its join code to the sandbox line from that phone, and your messages reach your inbox and webhooks. Replies are allowed for 24 hours after each message from the contact. Group chats and starting conversations are not supported.

## Response `200`

Sandbox line and contacts

- object
  - `sandbox` object
    - `accountId` string: Use as accountId to reply from the sandbox line
    - `handle` string: The sandbox line to message
    - `contactLimit` integer
  - `contacts` ImessageSandboxContact[]
    - `id` string
    - `handle` string: Phone (E.164) or lowercase Apple ID email
    - `status` 'pending' | 'active'
    - `joinText` string: Send this from the handle to the sandbox line to activate it
    - `joinLink` string: Opens Messages on the sandbox line with joinText prefilled
    - `activatedAt` string, date-time, nullable
    - `lastInboundAt` string, date-time, nullable: Replies are allowed for 24 hours after this
    - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid API key. `code` is `missing_credentials` when no Authorization header was sent and `invalid_credentials` when the key is unknown, revoked or expired.
- `403`: Your plan does not include the inbox
- `404`: The sandbox is not available right now

## Changes

- **2026-10-06** `f8c8f34fb41a`: 1 warning
  - added the new `account` enum value to the `details/budgetScope` response property for the response status `401`
- **2026-10-02** `d556591af3f6`: 7 info
  - added the optional property `code` to the response with the `401` status
  - added the optional property `details` to the response with the `401` status
  - added the optional property `docUrl` to the response with the `401` status
  - added the optional property `param` to the response with the `401` status
  - …3 more
- **2026-09-29** `69bbe3da3a18`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/zernio/apis/zernio-api/changes/v1/imessage/sandbox/contacts/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/1ba71fcdcb0d?raw)