Essentials
Calls
Contact Custom Fields
Contacts
Conversations
Phone Numbers
Get a message by ID
Get a message by its unique identifier.
curl --request GET \
--url https://api.openphone.com/v1/messages/{id}
{
"data": {
"id": "AC123abc",
"to": [
"+15555555555"
],
"from": "+15555555555",
"text": "Hello, world!",
"phoneNumberId": "PN123abc",
"direction": "incoming",
"userId": "US123abc",
"status": "sent",
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z"
}
}
Path Parameters
The unique identifier of a message
Response
The unique identifier of the message.
Array of recipient phone numbers in E.164 format. Includes your OpenPhone number for incoming messages.
A phone number in E.164 format, including the country code.
A phone number in E.164 format, including the country code.
The content of the message.
The unique identifier of the OpenPhone phone number that the message was sent from.
The direction of the message relative to the OpenPhone number.
incoming
, outgoing
The unique identifier of the user who sent the message. Null for incoming messages.
The status of the message.
queued
, sent
, delivered
, undelivered
The timestamp when the message was created at, in ISO 8601 format
The timestamp when the message status was last updated, in ISO 8601 format.
Was this page helpful?
curl --request GET \
--url https://api.openphone.com/v1/messages/{id}
{
"data": {
"id": "AC123abc",
"to": [
"+15555555555"
],
"from": "+15555555555",
"text": "Hello, world!",
"phoneNumberId": "PN123abc",
"direction": "incoming",
"userId": "US123abc",
"status": "sent",
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z"
}
}