---
title: "Get valid sending numbers and sender IDs"
method: GET
path: "/get-validnumbers/"
tags: ["Account Functions"]
---

# Get valid sending numbers and sender IDs

`GET /get-validnumbers/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/get-validnumbers/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

Get the virtual numbers, personal numbers and verified alphanumeric sender IDs the account can send from, plus the shared-pool row

## Query parameters

- `key` string, required

## Response `200`

Successfull response

- ValidNumberItem[]
  - `number` string: The virtual number, personal number, or alphanumeric sender ID; the literal string 'shared' for the shared-pool row
  - `name` string: Friendly name, or the number/sender ID itself if no friendly name is set
  - `type` 'virtual' | 'personal' | 'senderid' | 'shared': The kind of sending identity. 'shared' is the always-present shared-pool row: the actual sending number is chosen per destination at send time, so its region is nominal
  - `region` string: Country the number is registered to (virtual numbers and the shared-pool row only)

## Other responses

- `401`: Authentication failed or paramaters not provided

---

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