Request resources

Infobip provides several efficient methods for requesting your resources, supplying information about the status, and the progress of the request.

The request procedure ensures compliance with local regulations, enhances brand visibility, and improves message deliverability, for example:

• Regulations and compliance: many resources require country-specific approval and documentation before use, based on country-level compliance
• Branding and recognition: custom sender IDs and numbers help businesses maintain a professional image
• Channel-specific requirements: each channel has different rules for sender identities

Whether you are using the Resources API or the web interface, the steps for requesting resources follows the same high-level procedure.

High-level procedure for requesting resources

Follow the high-level procedure to request a resource:

1. Gather data requirements: collect all the relevant information for the request. Some resources require registration or for additional data to be provided. and these are known as data requirements.
2. Submit request: use your preferred method to submit the request. After Infobip receives your request, your data is validated against the specific requirements of the request.
3. Receive feedback: receive the feedback by one of the following methods:
   • Infobip team contacts you by email and shares feedback on the status of your request, particularly if data is missing or incorrect.
   • For alphanumeric sender requests and number purchases, the system first provides automatic validation feedback. When the request passes validation, it proceeds to an internal review. Feedback from this review is then delivered either through the API or using notification messages in My Requests.
4. Respond to feedback: update the request to meet the data requirements. Update the request using one of the following methods:
   • If your request is in the Action required status, you can edit your request (only for alpha sender requests) from the My requests page. This enables you to submit additional details that have been requested.
   • Update the data for the request over API depending on the current request status.
   • Send an email to Support to provide the updated data or amendments for your request.
5. Processing: Infobip proceeds with the registration/or procurement.
6. Completion: your request is complete.

The following table shows the possible supported request statuses.

Request status	Description
Pending	Request is being processed by Infobip. During this phase, the Infobip team may reach out by email for additional data or data updates.
Action required	Additional information or updates are needed from the user to proceed. Choose Edit request to provide the additional information about the request.
Rejected	Request has been cancelled by Infobip.
Completed	Request has completed.

Requesting resources over API

The Resource Request API supports the following request types:

• Alphanumeric registration
• Number purchase
• Depending on the resource type you select, additional parameters are expected.

The process of requesting resources over API uses the Resource Request endpoints (opens in a new tab) in the following order:

1. Get a list of the requirements for the resource (Get requirements endpoint (opens in a new tab)).
2. Upload the documents that are required to support the resource request (Upload documents endpoint (opens in a new tab)).
3. Submit the request for the resource (Submit resource request endpoint (opens in a new tab)).
4. Receive update notifications on the status of the request submission (Receive resource requests status updates webhook (opens in a new tab)).
5. For alphanumeric sender requests and number purchase requests: To update your alphanumeric sender request with the required additional data, use the Update resource request endpoint (opens in a new tab).
6. For alphanumeric sender requests and number purchase requests: If you no longer wish to proceed with the alphanumeric sender request, you can cancel your request using the Cancel resource request endpoint (opens in a new tab).

When you request resources, you are provided with visibility of the request status so that you know when you need to carry out an action.

The following table shows the possible supported statuses for when requesting resources over API.

Status	Description
PENDING	Request is being processed by Infobip. During this phase, the Infobip team may reach out by email for additional data or updates.
UPDATE_REQUESTED_BY_INTERNAL_REVIEWER	Infobip reviewer has requested additional information or corrections to the resource request. The request cannot proceed until the required updates are submitted. Validation feedback is provided via the requirementsFeedback array in a Get resource requests (opens in a new tab) call.
AUTOMATIC_VALIDATION	The request is undergoing automatic validation, checking data format, field requirements, value limits, and compliance with regular expressions.
UPDATE_REQUESTED	This status applies to both alphanumeric sender requests and number purchases. Automatic validation has detected issues in the submitted data and requires the requester to update the information. Validation feedback is provided via the requirementsFeedback array in a Get resource requests (opens in a new tab) call.
REJECTED	Infobip has rejected the request.
CANCELED	This status applies to both alphanumeric sender requests and number purchases. The request has been canceled by the requester or system.
COMPLETED	The request has been successfully processed and finalized.
PENDING_REVIEW	The request is awaiting review by Infobip after submission. This step precedes any automatic validation or manual assessment.
IN_REVIEW	The request is actively being reviewed by an Infobip team member to verify details, compliance, and completeness.
IN_PROGRESS	The request is being processed internally by Infobip but has passed initial validation. Further actions, such as approval, allocation, or provisioning, are in progress.

Get requirements

Use the Get requirements endpoint (opens in a new tab) to get the list of all relevant requirements for a specific request type. In the request, you specify the type of resource (number or alphanumeric sender) and the associated required parameters. For example:

• ALPHANUMERIC_REGISTRATION - specify the two-letter country code
• NUMBER_PURCHASE - specify the country code, and also the number type (SHORT_CODE, VIRTUAL_LONG_NUMBER, TEN_DIGIT_LONG_CODE, TOLL_FREE_NUMBER) and capabilities (SMS, VOICE, MMS).

The API returns a list of required data fields that must be provided when requesting the specified resource. The resource types are TEXT, INTEGER, EMAIL, URL, GSM, and DOCUMENT.

The request is validated to check the syntax, authorization, and permissions, and returns an error to indicate any violations. If any required field is missing, the request is rejected or requires additional input. In addition, TEXT and INTEGER can specify the following validation rules:

• TEXT - minimum length, maximum length, and the pattern of the string
• INTEGER - minimum value and maximum value

The following table shows the potential responses to this endpoint.

Response	Resource	Request
No requirements needed	Numbers	If an empty object is returned, the number does not require any additional documentation or data to proceed with the request.
No offer	Numbers	The number has no appropriate offers available. The following error code is returned RES-NUM-LOOKUP404.
No registration	Alphanumeric senders	Alphanumeric registration is not currently available. This may be because the country allows any sender to be used, or alphanumeric senders are not supported overall. For more information, see SMS Coverage and Connectivity.

You then use this information to gather the required data before submitting a request.

Upload document

Use the Upload documents endpoint (opens in a new tab) to upload a document so that it can be used as a requirement within a resource request.

Use this endpoint only if any of the requirements are of type DOCUMENT.

This endpoint returns an ID in response, which is then submitted with the API request.

Submit resource request

Use the Submit resource request endpoint (opens in a new tab) to submit a request with valid requirements data. You may be charged for the request, depending on the specific number or alphanumeric sender charging.

For 10DLC (number type TEN_DIGIT_LONG_CODE), if you want to use a number that belongs to a specific state or with a specific npa or nxx, you can provide information about the state, npa, or nxx within the requirements object.

Receive updates webhook

You can be notified of any changes to the resource request status using the Receive resource requests status updates webhook (opens in a new tab).

When there is a change in the status, the webhook returns an event specifying the status of the request. For example, COMPLETED or REJECTED.

Update resource request

When you submit alphanumeric senders (ALPHANUMERIC_REGISTRATION) or number purchases (NUMBER_PURCHASE) requests, the review process by the Infobip Registrations team and automatic validation may detect issues with the supplied requirements data. Any validation issues are returned in the requirementsFeedback array of objects from a Get resource requests (opens in a new tab) endpoint.

When an alphanumeric senders (ALPHANUMERIC_REGISTRATION) or number purchases (NUMBER_PURCHASE) request is in UPDATE_REQUESTED or UPDATE_REQUESTED_BY_INTERNAL_REVIEWER status, you can update the request using the Update resource request (opens in a new tab) endpoint and the request identifier.

Alternatively, if your request is in the Action required status, you can edit your request (only for alpha sender requests) from the My requests page or in the Numbers app for number purchase requests. This enables you to submit additional details that have been requested.

Cancel resource request

When an alphanumeric senders (ALPHANUMERIC_REGISTRATION) or number purchase (NUMBER_PURCHASE) request is in UPDATE_REQUESTED or UPDATE_REQUESTED_BY_INTERNAL_REVIEWER status, you can submit a request to cancel using the Cancel resource request (opens in a new tab) endpoint and the request identifier. If you cancel an existing request over API, this cancels the request with Infobip.

Additionally, you can cancel a request through the web interface, depending on whether it is an alphanumeric sender or a number purchase request.

Requesting resources over web interface

You can request resources from Channels and Numbers in the Infobip web interface (opens in a new tab). Login using your Infobip account, go to Channels and Numbers and select either Channels, Numbers, or My requests.

For example, you can:

• Buy a number from Numbers
• Request an alphanumeric sender from Channels > SMS
• Request a channel or sender from My requests

When you request resources, you are provided with visibility of the request status so that you know when you need to carry out an action.

The following table shows the possible supported statuses when requesting resources over the web interface.

Request status	Status icon color	Description
Pending	Yellow	Request is being processed by Infobip. During this phase, the Infobip team may reach out by email for additional data or data updates.
Action required	Red	Automatic validation has identified issues with the requirements data that was provided, and this requires the request to be updated. When requests are in this status, there is the option to cancel.
Rejected	Red	Request has been rejected by Infobip.
Canceled	Grey	Request has been cancelled.
Completed	Green	Request has completed.

Buy number from Numbers

To buy numbers from Numbers in Channels and Numbers:

1. Go to Channels and Numbers > Numbers.
2. Click Buy Number.
3. For more information, see Buy numbers.

Request alphanumeric sender from SMS

To request an alphanumeric sender from SMS in Channels and Numbers:

1. Go to Channels and Numbers > Channels > SMS.
2. Under Alphanumeric Sender ID, click Request Sender.
3. For more information, see Submit MyRequests.

Request channel from My requests

To request a channel or a sender from My requests in Channels and Numbers:

1. Go to Channels and Numbers > My requests.
2. Click Request Channel.
3. For more information, see Submit MyRequests.