---
title: Bulk Sender ID Registration - REST API 
description: SMS Global Knowledgebase
---

[![](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo.svg)](https://smsglobal.com?hsLang=en-au)

 smsglobal.com [Talk to an expert](https://www.smsglobal.com/contact?hsLang=en-au)  Talk to an expert

[Skip to content](https://knowledgebase.smsglobal.com/bulk-sender-id-registration-rest-api-smsglobal-help-center#main-content)

[![SMSGLOBAL LOGO WHITE-2](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGLOBAL%20LOGO%20WHITE-2.png?width=500&height=100&name=SMSGLOBAL%20LOGO%20WHITE-2.png)](https://www.smsglobal.com/?hsLang=en-au)

Open main navigation

Close main navigation

- [Contact us](https://www.smsglobal.com/contact/)

[Contact us](https://www.smsglobal.com/contact/?hsLang=en-au)

 Advice and answers from the SMSGlobal Team

- There are no suggestions because the search field is empty.

1. [SMS Global Knowledgebase](https://knowledgebase.smsglobal.com/?hsLang=en-au)
2. [Sender ID](https://knowledgebase.smsglobal.com/sender-id?hsLang=en-au)

# Bulk Sender ID Registration - REST API 

## To create sender IDs in bulk, you can use the SMSGlobal REST API endpoint. Please see the required structure below:

**Endpoint: /v2/sender-id**

- **Obtain Sender ID list:**

***GET*** /v2/sender-id

***Parameters:***

| **Name** | **Requirement** | **Type** | **Description** |
| --- | --- | --- | --- |
| id | \\d+ | integer | The sender id identifier. |

***Return:***

| **Parameter** | **Type** | **Versions** | **Description** |
| --- | --- | --- | --- |
| total | integer | >=v2 | Total number of sender id objects |
| offset | integer | >=v2 | Pagination Offset (default 1) |
| limit | integer | >=v2 | Number of sender id objects to return |
| senderIds\[\] | array of objects (SenderIdRegistration) | >=v2 | A collection of sender id objects |
| senderIds\[\]\[id\] | integer | \* | Id |
| senderIds\[\]\[senderId\] | string | \* | Sender id |
| senderIds\[\]\[createdDate\] | DateTime | \* | Created date |
| senderIds\[\]\[updatedDate\] | DateTime | \* | Updated date |
| senderIds\[\]\[country\] | string | \* | Country |
| senderIds\[\]\[status\] | string | \* | Status |

***Status Codes:***

| **Status Code** | **Description** |
| --- | --- |
| [200](http://en.wikipedia.org/wiki/HTTP_200) | Returned when successful |
| [400](http://en.wikipedia.org/wiki/HTTP_400) | Returned when input validation failed |
| [403](http://en.wikipedia.org/wiki/HTTP_403) | Returned when the user is not authorized |
| [404](http://en.wikipedia.org/wiki/HTTP_404) | Returned when the contact is not found |
| [405](http://en.wikipedia.org/wiki/HTTP_405) | Method not allowed |

- **Submit new Sender Id:**

***POST*** /v2/sender-id stable since v2

***Parameters:***

| **Parameter** | **Type** | **Required?** | **Format** | **Description** |
| --- | --- | --- | --- | --- |
| senderId | string | TRUE |   | Sender Id |
| country | choice | TRUE |   | Country |
| description | string | TRUE |   | A brief description on how are you going to use this Sender Id |
| businessName | string | TRUE |   | BusinessName |
| abn | string | TRUE |   | ABN/ACN/ARBN/ICN /CRN |
| name | string | TRUE |   | Name |
| email | string | TRUE |   | Email |
| phone | string | TRUE |   | Phone |
| industry | string | TRUE |   | Industry |
| contactMethod | choice | TRUE | Select either {"Phone" or Email"} | Contact Method |
| businessLicense | file | TRUE |   | Proof your company is legally registered. (e.g., Certificate of Incorporation, Business License, ABN, ASIC, etc.). Document. Max 10MB |
| proofOfRelationship | file | Optional |   | Please provide a document that clearly demonstrates the relationship between the parent and subsidiary company. Confirms the parent-company connection. Max 10MB |
| proofOfOwnership | file | Optional |   | Proof of Ownership Document. Please submit a document that verifies your ownership of, or rights to use, the brand name you wish to register as your sender ID. Suitable forms of evidence include. Max 10MB |

***Return:***

| **Parameter** | **Type** | **Versions** | **Description** |
| --- | --- | --- | --- |
| id | integer | \* | Id |
| senderId | string | \* | Sender id |
| createdDate | DateTime | \* | Created date |
| updatedDate | DateTime | \* | Updated date |
| country | string | \* | Country |
| status | string | \* | Status |

***Status Codes:***

| **Status Code** | **Description** |
| --- | --- |
| [200](http://en.wikipedia.org/wiki/HTTP_200) | Returned when successful |
| [400](http://en.wikipedia.org/wiki/HTTP_400) | Returned when input validation failed |
| [402](http://en.wikipedia.org/wiki/HTTP_402) | Returned when account is out of credits |
| [403](http://en.wikipedia.org/wiki/HTTP_403) | Returned when the user is not authorized |
| [405](http://en.wikipedia.org/wiki/HTTP_405) | Method not allowed |

- **Get the Sender Id as identified by the given id.**

***GET*** /v2/sender-id/{id}

***Requirements:***

| **Name** | **Requirement** | **Type** | **Description** |
| --- | --- | --- | --- |
| id | \\d+ | integer | The sender id identifier. |

***Return:***

| **Parameter** | **Type** | **Versions** | **Description** |
| --- | --- | --- | --- |
| id | integer | \* | Id |
| senderId | string | \* | Sender id |
| createdDate | DateTime | \* | Created date |
| updatedDate | DateTime | \* | Updated date |
| country | string | \* | Country |
| status | string | \* | Status |

***Status Codes:***

| **Status Code** | **Description** |
| --- | --- |
| [200](http://en.wikipedia.org/wiki/HTTP_200) | Returned when successful |
| [403](http://en.wikipedia.org/wiki/HTTP_403) | Returned when the user is not authorized |
| [404](http://en.wikipedia.org/wiki/HTTP_404) | Returned when the contact is not found |
| [405](http://en.wikipedia.org/wiki/HTTP_405) | Method not allowed |

- [Sending a SMS](https://knowledgebase.smsglobal.com/sending-a-sms?hsLang=en-au)
- [Sender ID](https://knowledgebase.smsglobal.com/sender-id?hsLang=en-au)
- [API and Integration](https://knowledgebase.smsglobal.com/api-and-integration?hsLang=en-au)
- [Email to SMS](https://knowledgebase.smsglobal.com/email-to-sms?hsLang=en-au)
- [Reporting](https://knowledgebase.smsglobal.com/reporting?hsLang=en-au)
- [Sub-Accounts](https://knowledgebase.smsglobal.com/sub-accounts?hsLang=en-au)
- [Delivery Receipts](https://knowledgebase.smsglobal.com/delivery-receipts?hsLang=en-au)
- [Billing and Payments](https://knowledgebase.smsglobal.com/billing-and-payments?hsLang=en-au)
- [Contact Lists](https://knowledgebase.smsglobal.com/contact-lists?hsLang=en-au)
- [Managing Opt-Outs](https://knowledgebase.smsglobal.com/managing-opt-outs?hsLang=en-au)
- [Campaigns](https://knowledgebase.smsglobal.com/campaigns?hsLang=en-au)
- [Templates](https://knowledgebase.smsglobal.com/templates?hsLang=en-au)
- [MMS](https://knowledgebase.smsglobal.com/mms?hsLang=en-au)
- [Voice](https://knowledgebase.smsglobal.com/voice?hsLang=en-au)
- [Laws and Regulations](https://knowledgebase.smsglobal.com/laws-and-regulations?hsLang=en-au)
- [Video Tutorials](https://knowledgebase.smsglobal.com/video-tutorials?hsLang=en-au)
- [Account Settings](https://knowledgebase.smsglobal.com/account-settings?hsLang=en-au)
- [Understanding Unicode Messages](https://knowledgebase.smsglobal.com/understanding-unicode-messages?hsLang=en-au)

[![SMSGlobal](https://knowledgebase.smsglobal.com/hs-fs/hubfs/SMSGlobal-logo-black-transp.png?width=200&height=56&name=SMSGlobal-logo-black-transp.png "SMSGlobal")](http://smsglobal.com?hsLang=en-au)

[mailto:support@email.com](mailto:support@email.com)

Copyright © 2026, SMSGlobal

![](https://analytics.twitter.com/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0) ![](https://t.co/i/adsct?txn_id=nxnc4&p_id=Twitter&tw_sale_amount=0&tw_order_quantity=0)

[![SMSGlobal](https://cdn.craft.cloud/ff00d28e-6061-427e-b58d-8267ebeaad6b/builds/a173c27c-7ed2-40a3-b553-3262aea64d9e/artifacts/dist/img/logo/sms-global-logo-light.svg)](https://smsglobal.com/?hsLang=en-au)

 © Copyright . SMSGlobal. All rights reserved.

[smsglobal.com](https://smsglobal.com/?hsLang=en-au) [Talk to an expert](https://smsglobal.com/contact/?hsLang=en-au)