Kirim icon

Kirim

Send WhatsApp messages and manage your inbox via the Kirimdev API

Message → List

AI-generated

Summary

List messages for a selected WhatsApp account, optionally filtering by conversation, direction, status, or creation time. Use the cursor from a previous response to request another page.

Inputs

  • From Account Name or ID (required) — WhatsApp account whose messages to list.
  • Conversation ID — Restrict results to one conversation; leave empty to list across the account.
  • Direction — Filter to inbound or outbound messages, or choose All.
  • Status — Filter by delivered, failed, pending, read, or sent status, or choose All.
  • Created After — ISO-8601 timestamp; include messages created at or after this time.
  • Created Before — ISO-8601 timestamp; include messages created strictly before this time.
  • Limit — Maximum results per request; defaults to 50, with a declared range of 1–100.
  • Cursor — Opaque pagination cursor, typically the previous response’s next_cursor.

Output shape

A single response object containing the message list and pagination data.

Automatic pagination is disabled; use the returned next_cursor to fetch subsequent pages. The exact response fields are determined by the API.

Links

Discussion