# Get SMS messages

**GET /sms/messages**




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



## Parameters


### Query parameters
- **from** (array[string])
  Filter based on the from msisdn
- **ref** (string)
  Filter based on the ref of the message; can be null to filter on messages without a reference
- **paused** (boolean)
  Filter based on whether the message is paused or not
- **completed** (boolean)
  Filter based on whether the message has finished/completed
- **messageID.min** (integer)
  Return messages whose messageID is greater than or equal to this value
- **messageID.max** (integer)
  Return messages whose messageID is less than or equal to this value
- **created_at.min** (string(date-time))
  Return message created on or after this time; default is 24 hours ago
- **created_at.max** (string(date-time))
  Return message created on or before this time
- **limit** (integer)
  Max number of messages to return (default 100, max 500)
- **offset** (integer)
  Number of messages to skip (for pagination use)
- **sort** (string | array[string])
  Csv or array of sort field definitions, default is "-messageID" which means descending order of messageID, ie newest messages first


## Responses
### 200
Successful operation

#### Body: application/json (object)
- **data** (array[object])

- **more_results** (boolean)
  Are there more results which have not been included

### 400
Invalid input

### 401
Unauthorized

#### Body: application/json (object)
- **status_code** (integer)
  Status code 401
- **status_msg** (string)
  Error message text

### 403
Invalid input


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