Skip to main content
GET
Error

Authorizations

Authorization
string
header
required

Authorization Code flow against Dialbird's OIDC provider. The issued access token is a JWT with aud: "public-api", verified against the issuer JWKS.

FlowAuthorization Code
Authorization URL
https://app-staging.dialbird.io/oidc/auth
Token URL
https://app-staging.dialbird.io/oidc/token
Refresh URL
https://app-staging.dialbird.io/oidc/token
Scopes1
api:messages:read
Read messages.

Query Parameters

limit
integer
default:25
Required range: 1 <= x <= 100
cursor
string

Opaque cursor from a previous response's next_cursor.

inbox_id
string

Only conversations on this inbox (see GET /inboxes).

contact_id
string

Only conversations with this saved contact.

archived
boolean
default:false

Response

One page of conversations.

data
object[]
required
next_cursor
string | null
required