# 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](https://www.infobip.com/docs/myrequests).
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](https://www.infobip.com/docs/myrequests/manage-myrequests#edit-a-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](https://www.infobip.com/docs/resources/request-resources#requesting-resources-over-api) depending on the current request status.
   - Send an email to [Support](mailto:support@infobip.com) 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](https://www.infobip.com/docs/api/platform/resources/resource-request) in the following order:

1. Get a list of the requirements for the resource ([Get requirements endpoint](https://www.infobip.com/docs/api/platform/resources/resource-request/resources-requirements-lookup)).
2. Upload the documents that are required to support the resource request Upload documents endpoint.
3. Submit the request for the resource Submit resource request endpoint.
4. Receive update notifications on the status of the request submission Receive resource requests status updates webhook.
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.
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.

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 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 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 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](https://www.infobip.com/docs/essentials/getting-started/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 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 to submit a request with valid requirements data. You may be charged for the request, depending on the specific number or alphanumeric sender charging.

Note
Some numbers do not require additional data. Use Get requirements for all the necessary data.

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.

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 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 endpoint and the request identifier.

Alternatively, if your request is in the **Action required** status, you can [edit your request](https://www.infobip.com/docs/myrequests/manage-myrequests#edit-a-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 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](https://www.infobip.com/docs/numbers/getting-started#manage-number-requests-numbers-over-web-interface) or a [number purchase request](https://www.infobip.com/docs/numbers/getting-started#cancelling-numbers-over-web-interface-numbers-over-web-interface).

## Requesting resources over web interface

You can request resources from **Channels and Numbers** in the [Infobip web interface](https://portal.infobip.com//). 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. |

Note
Update and Cancel request for alphanumeric senders or number purchases is available to selected accounts only. To start using this feature, contact [Support](mailto:support@infobip.com) or your Infobip account manager.

### 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](https://www.infobip.com/docs/numbers/getting-started).

### 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](https://www.infobip.com/docs/myrequests/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](https://www.infobip.com/docs/myrequests/submit-myrequests).