Get Message by ID | Pinnacle

Retrieve a previously sent message.

idintegerRequired>=1

Unique identifier of the message.

PINNACLE-API-KEYstringRequired

Successfully retrieved the message.

contentobject

Content type of the message.

costdouble or null

Total cost charged for sending the message.

Null means the message incurred no cost or has not been charged yet.

deliveredAtstring or null

Timestamp indicating when the message was successfully delivered to the recipient.

Null indicates the message has not yet been delivered.

errorstring or null

Detailed explanation of any errors that occurred while delivering the message.

Null indicates no errors.

idinteger

Unique identifier of the message.

methodenum

Method used to send the message.

Allowed values:

numSegmentsinteger

Number of segments the message was split into for delivery.

receiverstring

Phone number that received the message in E.164 format.

senderstring

Phone number or agent that sent the message.

sentAtstring or null

Timestamp indicating when the message was submitted for delivery.

Null indicates the message is still in the queue.

statusenum

Current status of the message.

typeenum

Delivery protocol used for sending this message.

Allowed values:

1	import { PinnacleClient } from "rcs-js";
2
3	async function main() {
4	const client = new PinnacleClient({
5	environment: "https://api.pinnacle.sh",
6	});
7	await client.messages.get(1240);
8	}
9	main();

1	{
2	"content": {
3	"text": "Hello from Pinnacle"
4	},
5	"cost": 10,
6	"deliveredAt": null,
7	"error": "{\"message\": \"Error: Timeout occurred\"}",
8	"id": 1240,
9	"method": "API",
10	"numSegments": 1,
11	"receiver": "+1415654321",
12	"sender": "+1415567890",
13	"sentAt": "2025-06-18T21:27:13.809",
14	"status": "PENDING",
15	"type": "SMS"
16	}