Overview
Uptrends integrations send alerts when your monitors detect any errors or issues. With the phone alert integration, you’ll get a call with an automated message about the alert, so you’re instantly informed about the situation.
Use case
The OutgoingPhoneNumber API lists all outgoing phone numbers used as official caller IDs for Uptrends alerts.
Prerequisites
Before using the OutgoingPhoneNumber API, make sure you have:
OutgoingPhoneNumber API fields
The OutgoingPhoneNumber API contains various API fields:
| Field name | Description |
|---|---|
Id |
The unique identifier of the outgoing phone number. |
PhoneNumber |
The international phone number used by Uptrends:
|
Description |
The country associated with the phone number:
|
For more information about the list of supported countries for phone alert integration, refer to Phone alerts troubleshooting.
OutgoingPhoneNumber API endpoints
The OutgoingPhoneNumber API provides the following endpoints:
| Method | Endpoint | Description |
|---|---|---|
GET |
/OutgoingPhoneNumber |
Retrieve a list of all the official Uptrends outgoing phone numbers. |
For detailed request and response formats and interactive API testing, refer to the Uptrends OutgoingPhoneNumber API documentation.
Troubleshooting
This section covers common HTTP errors and troubleshooting steps for the OutgoingPhoneNumber API.
Common errors
Common HTTP status codes and their descriptions:
| Status Code | Description |
|---|---|
| 200 | OK — request successful. |
| 400 | Bad request — invalid request parameters or missing required fields. |
| 500 | Internal Server Error — a server-side error occurred. |
General troubleshooting guide
Ensure that you:
- Always validate your request data before sending API calls.
- Use appropriate HTTP methods for each operation.
For further assistance, please reach out to our Support team.
Related articles
For more details, refer to the following articles:
- Uptrends OutgoingPhoneNumber API documentation — an interactive API documentation with detailed endpoint specifications.
- API changelog - for latest API updates and deprecation notices.
- Alerting overview — read this article to help you get started with the basics of alerting.