addedInput schema / properties / account_id
Added value: +{
+ "description": "only this account's messages, from wa_list_accounts; omit for every account",
+ "type": "string"
+}
addedInput schema / properties / chat
Added value: +{
+ "description": "only this conversation — a phone number or a group JID",
+ "type": "string"
+}
addedInput schema / properties / include_history
Added value: +{
+ "description": "also return imported history (pairing sync and wa_load_history); off by default. With it on, a page is in storage order rather than time order — sort by at",
+ "type": "boolean"
+}
addedInput schema / properties / since
Added value: +{
+ "description": "only messages sent at or after this time: RFC3339 with a zone (2026-10-01T09:00:00+03:00) or a date (2026-10-01 = midnight UTC); omit for no lower bound",
+ "type": "string"
+}
addedInput schema / properties / until
Added value: +{
+ "description": "only messages sent BEFORE this time — exclusive, so all of 1 October is since 2026-10-01 until 2026-10-02; same formats as since; omit for no upper bound",
+ "type": "string"
+}
addedOutput schema / properties / messages / items / properties / account_name
Added value: +{
+ "description": "the WhatsApp display name of that account",
+ "type": "string"
+}
addedOutput schema / properties / messages / items / properties / account_phone
Added value: +{
+ "description": "the phone number of your account this message was sent from or received on, E.164",
+ "type": "string"
+}
addedOutput schema / properties / messages / items / properties / attachment
Added value: +{
+ "additionalProperties": false,
+ "description": "present on an image, video, audio, document or sticker message: the file's mime type, size and name; fetch the bytes with wa_get_media",
+ "properties": {
+ "available": {
+ "description": "true when the file should be fetchable with wa_get_media(account_id, message_id) — a live received attachment; false for history and for files you sent, which are not kept",
+ "type": "boolean"
+ },
+ "file_name": {
+ "description": "documents only: the file name the sender gave it",
+ "type": "string"
+ },
+ "mime": {
+ "description": "the attachment's mime type as the sender declared it, e.g. image/jpeg or application/pdf; empty for a message stored before this was recorded",
+ "type": "string"
+ },
+ "size": {
+ "description": "the attachment's size in bytes as the sender declared it; 0 when unknown",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "available"
+ ],
+ "type": [
+ "null",
+ "object"
+ ]
+}
addedOutput schema / properties / messages / items / properties / received_at
Added value: +{
+ "description": "when this server received and stored the message, RFC3339; later than at for a message delivered late or loaded as history",
+ "type": "string"
+}
addedOutput schema / properties / messages / items / properties / sender_name
Added value: +{
+ "description": "who wrote the message, by name: for inbound the sender's name as saved in this account's contacts, or else the name they chose for themselves; for outbound this account's own WhatsApp name. Empty when no name is known",
+ "type": "string"
+}
addedOutput schema / properties / refusal
Added value: +{
+ "additionalProperties": false,
+ "description": "present only when the request was declined; next_cursor is then your after_cursor, unchanged",
+ "properties": {
+ "message": {
+ "description": "a human-readable explanation",
+ "type": "string"
+ },
+ "reason": {
+ "description": "why the call was declined",
+ "type": "string"
+ },
+ "refused": {
+ "description": "true when the call was declined rather than performed",
+ "type": "boolean"
+ },
+ "retry_after_seconds": {
+ "description": "seconds to wait before retrying; absent or 0 means retrying will not help",
+ "type": "integer"
+ }
+ },
+ "required": [
+ "refused",
+ "reason",
+ "message"
+ ],
+ "type": [
+ "null",
+ "object"
+ ]
+}