# Barritel SMS

## Description
This is version `1.0.0` of this API documentation. Last update on Jun 24, 2024.
API Documentation for Barritel SMS messages

## Field Formats
### msisdns (phone numbers)
msisdns should be provided in E164 format. The leading “+” is optional but you may provide it if you wish. Any msisdns returned in responses will always have the leading “+”.
eg, to provide UK phone number 07700 900999, you may specify this as 447700900999 or +447700900999. This will always be returned as +447700900999.


### Timestamps
All date-time fields can be specified in the following formats:
- 1717409122 (unix timestamp)
- 2024-06-03 10:05:22 (no timezone - account default timezone [normally UTC] assumed)
- 2024-06-03T10:05:22Z (ISO8601 format with “Z” (UTC) timezone specified)
- 2024-06-03T07:05:22-0300 (ISO8601 format with UTC -3hrs timezone specified)

## Endpoints
In addition to endpoint specific supported methods, every endpoint supports the OPTIONS HTTP method. This method returns a list of HTTP methods that the particular endpoint supports.

## Webhooks
Webhooks are used to send delivery reports and inbound SMS messages. If we do not get a response or a response code of 429/5xx from the server we will try again. If we get a response code of 4xx or 3xx we will not reattempt to send the message.

## Servers
- https://sms.apicontrol.co.uk/v1: https://sms.apicontrol.co.uk/v1 ()

## Authentication




## Endpoints and operations

### [Inbound SMS](https://sms.doc.barritel.com/group/endpoint-inbound-sms.md)
- [Get SMS messages](https://sms.doc.barritel.com/operation/operation-indexinboundsms.md)
- [Get SMS message](https://sms.doc.barritel.com/operation/operation-getinboundsms.md)
### [Outbound SMS](https://sms.doc.barritel.com/group/endpoint-outbound-sms.md)
- [Send a new SMS](https://sms.doc.barritel.com/operation/operation-sendsms.md)
- [Get SMS messages](https://sms.doc.barritel.com/operation/operation-indexoutboundsms.md)
- [Get SMS message](https://sms.doc.barritel.com/operation/operation-getoutboundsms.md)
- [Get SMS message with options](https://sms.doc.barritel.com/operation/operation-getoutboundsmsoptions.md)

## Webhooks

### [Delivery Report](https://sms.doc.barritel.com/group/webhook-delivery-report.md)
- [Receive delivery notifications](https://sms.doc.barritel.com/operation/operation-webhookdeliveryreport.md)
### [Inbound SMS](https://sms.doc.barritel.com/group/webhook-inbound-sms.md)
- [Receive inbound SMS](https://sms.doc.barritel.com/operation/operation-webhookinboundsms.md)



[Powered by Bump.sh](https://bump.sh)