---
title: "Gets the messages for a specific subscriber"
method: GET
path: "/endpoints/messages/{phoneNumber}"
tags: ["Messages"]
---

# Gets the messages for a specific subscriber

`GET /endpoints/messages/{phoneNumber}`

## Request

- Base URL: `https://app.hullo.me/api`
- URL: `https://app.hullo.me/api/endpoints/messages/{phoneNumber}`
- Auth: API key in header `X-API-KEY`

Retrieves any messages sent / received for a specific subscriber. The messages will be ordered by date 
descending, so the newest messages will appear at the top.

## Path parameters

- `phoneNumber` string, required

## Query parameters

- `limit` integer

## Response `200`

OK

- Message[]: A list of messages
  - `id` string: The unique ID for the message once submitted
  - `issueDate` string, date-time: The date the message was will be / was issued. When sending a message this date should be at least 2 minutes in the future
  - `phoneNumber` string, phone-number, required: The phone number the message was sent to / received from
  - `messageText` string, required: The message text to send / was sent to the member
  - `fullName` string: The full name of the member the message was sent to (read only)
  - `inbound` boolean: If the message was received from a members phone then this will be marked as true (read only)
  - `deliveryStatus` 'FAILED' | 'ACCEPTED' | 'DELIVERED' | 'ISSUED' | 'REJECTED' | 'UNKNOWN' | 'PENDING' | 'STAGING' | 'N/A': The status of the message (read only).

## Other responses

- `401`: UNAUTHORIZED
- `404`: NOT_FOUND

---

[API](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api.md) · [All operations](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hullo/apis/always-on-mobile-hullo-api/revisions/62982404791d?raw)