---
title: "List sender IDs for a recipient"
description: "Returns the sender IDs you can use to message a specific recipient number, based on its country."
version: "v2"
---

> Documentation Index
> Fetch the complete documentation index at: https://dev.messageport.com.au/llms.txt
> Use this file to discover all available pages before exploring further.

Path: MessagePort API › Account

`GET /v2/account/sender-ids/for/{number}`

Returns the sender IDs you can use to message a specific recipient number, based on its country.

## Authentication

- `basicAuth`, http, header `Authorization`

## Path parameters

- `number` (`listSenderIdsForNumber.path.number`; string, required) — Recipient phone number, ideally in E.164 format.

## Query parameters

- `message_type` (`listSenderIdsForNumber.query.message_type`; string, optional) — Return sender IDs that can send this type of message.
  - one of `"sms"`, `"mms"`; default `"sms"`

## Code samples

### cURL

```bash
curl --request GET \
  --url https://app.messageport.com.au/api/v2/account/sender-ids/for/%2B61412345678 \
  --header 'Authorization: Basic <credentials>'
```

### TypeScript

```typescript
const url = 'https://app.messageport.com.au/api/v2/account/sender-ids/for/%2B61412345678';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://app.messageport.com.au/api/v2/account/sender-ids/for/%2B61412345678"

headers = {"Authorization": "Basic <credentials>"}

response = requests.get(url, headers=headers)

print(response.text)
```

## Responses

### 200

Sender IDs usable for this recipient.

#### Example

```json
{
  "data": [
    {
      "type": "dedicated",
      "type_description": "Dedicated",
      "sender_id": "61491570159",
      "label": "61491570159 (Virtual Number)",
      "enabled": true,
      "default": true,
      "acma_unverified": false,
      "verify_url": null
    }
  ]
}
```

- `data` (`listSenderIdsForNumber.response.200.data`; array<object>, optional)
  - `type` (`listSenderIdsForNumber.response.200.data.type`; string, optional)
    - one of `"own"`, `"shared"`, `"dedicated"`, `"verified"`, `"custom"`
  - `type_description` (`listSenderIdsForNumber.response.200.data.type_description`; string, optional)
  - `sender_id` (`listSenderIdsForNumber.response.200.data.sender_id`; string, optional) — Value to pass as `from` when sending.
  - `label` (`listSenderIdsForNumber.response.200.data.label`; string, optional)
  - `enabled` (`listSenderIdsForNumber.response.200.data.enabled`; boolean, optional)
  - `default` (`listSenderIdsForNumber.response.200.data.default`; boolean, optional) — Whether this is your default sender ID.
  - `acma_unverified` (`listSenderIdsForNumber.response.200.data.acma_unverified`; boolean, optional) — The sender ID is not yet registered with the ACMA Sender ID Register.
  - `verify_url` (`listSenderIdsForNumber.response.200.data.verify_url`; string | null, optional) — Where to complete registration, if required.

### 401

Missing, malformed or invalid API credentials.

#### Example

```json
{
  "message": "Unauthenticated."
}
```

- `message` (`listSenderIdsForNumber.response.401.message`; string, required)

### 422

The request failed validation. `errors` lists the messages for each invalid field.

#### Example

```json
{
  "message": "The messages field is required.",
  "errors": {
    "messages": [
      "The messages field is required."
    ]
  }
}
```

- `message` (`listSenderIdsForNumber.response.422.message`; string, optional)
- `errors` (`listSenderIdsForNumber.response.422.errors`; map<array<string>>, optional)


Source: https://dev.messageport.com.au/api/account/list-sender-ids-for-number/index.md