Where a notification went

GET

/v1/messages/{id}/deliveries

curl --request GET \
  --url https://api.pocketbell.dev/v1/messages/msg_01jz9k6q8r3tfv0x2m4n5p7s8a/deliveries \
  --header 'Authorization: Bearer <token>'

Each device it was sent to: sent, delivered (as the device reported) or failed, and when. Only recorded states.

Authorizations

• session

Parameters

Path Parameters

id

required

string

Example

msg_01jz9k6q8r3tfv0x2m4n5p7s8a

Responses

200

The deliveries.

Media typeapplication/json

object

deliveries

required

Array<object>

object

device

required

Null for a device since signed in to another account: no longer this one’s to name.

string | null

platform

required

string

Allowed values: ios ipados macos

status

required

string

Allowed values: queued sent delivered failed

sent_at

required

string | null format: date-time

delivered_at

required

Reported by the device: best effort.

string | null format: date-time

Example

{
  "deliveries": [
    {
      "device": "iPhone",
      "platform": "ios",
      "status": "queued"
    }
  ]
}

401

Missing or ended session.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

details

Which fields were wrong, for invalid_request.

Array<object>

object

field

required

string

message

required

string

Example

{
  "error": {
    "code": "invalid_request"
  }
}

404

No such message on this account.

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

details

Which fields were wrong, for invalid_request.

Array<object>

object

field

required

string

message

required

string

Example

{
  "error": {
    "code": "invalid_request"
  }
}