Skip to main content
GET
List SMS

Authorizations

Authorization
string
header
required

Pass a Dugble team token in the Authorization header as Bearer . Team token secrets use the dgb_team_ prefix.

Query Parameters

limit
integer<int32>

Maximum number of records to return. Most offset-paginated endpoints default to 50 and cap at 100.

Required range: 1 <= x <= 100
offset
integer<int32>

Number of records to skip.

Required range: x >= 0
status
enum<string>

Filter by exact normalized SMS status.

Available options:
queued,
processing,
submitted,
sent,
delivered,
undelivered,
rejected,
failed,
expired,
unknown,
canceled
sender
string

Filter by exact sender identity matching the response from value.

start_date
string<date-time>

Include messages created at or after this RFC 3339 timestamp.

end_date
string<date-time>

Include messages created at or before this RFC 3339 timestamp. Must not precede start_date.

Case-insensitive partial match across recipient, sender, body, or provider message ID.

Response

SMS messages retrieved successfully.

success
enum<boolean>
required
Available options:
true
data
object[]
required