GET https://skyden.kiloconnectrdc.com/api/v1/messages

List Messages

List messages for your project with optional filters and pagination.

API key required application/json

Query Parameters

status Optional

string (queued | sent | delivered | read | failed)

Filter by status.

to Optional

string

Filter by recipient phone number.

page Optional

integer

Page number (default: 1).

per_page Optional

integer

Items per page (default: 20, max: 100).

Code Examples

curl -X GET 'https://skyden.kiloconnectrdc.com/api/v1/messages?status=sent&page=1' \
  -H 'Authorization: Bearer sks_live_xxxxx'

<?php
use Skyden\Send\SkydenSend;

SkydenSend::config('sks_live_xxxxx');

$messages = SkydenSend::client()->get('/messages', ['status' => 'sent']);

import { SkydenSend } from 'skyden-send';

SkydenSend.config('sks_live_xxxxx');

const messages = await SkydenSend.client().get('/messages', { status: 'sent' });

Success Response

200 OK

{
  "success": true,
  "data": [
    {"id": "01a094...", "status": "sent", "to": "243812345678"},
    {"id": "01a095...", "status": "delivered", "to": "243812345679"}
  ],
  "meta": {
    "current_page": 1,
    "per_page": 20,
    "total": 42,
    "last_page": 3
  }
}