Skip to main content

Retrieve SMS Messages

The Recording API enables customers to retrieve SMS messages, after receiving a [webhook notification]. Use the [Recording API] to retrieve the associated message, including its content, using the identifier recording_id provided in the notification. The partner platform calls this endpoint using the recording_id received in the webhook to fetch the full message text (content) and metadata, allowing the partner app to reconstruct unified conversation history. Your account must be provisioned by 1GLOABL for the SMS recording service.

Use Cases​

  • Unified Enterprise Conversation History: 1GLOBAL captures inbound and outbound SMS and synchronizes events and content to the partner platform. This allows the partner client to reconstruct end-to-end conversation threads with external contacts.
  • Privacy-First Architecture: The SMS Message content is encrypted at rest and pulled on-demand only by authorized enterprise tenants subject to market-specific retention rules.

Pre-requisities​

  • Valid API client credentials for obtaining a Bearer JWT.
  • Your account must be provisioned by 1GLOBAL for the SMS recording service.
  • The recording_api entitlement is enabled for your account.
  • Your API client has the recordings.read permission for the relevant account.
  • The requested message must be within its configured retention period.
GET https://api.1global.com/enterprise/recordings/{recording_id}

The header should contain the endpoint URL along with the subscriber Id, Request Access Token, and content-type as shown below:The header must contain the URL, recording_id and content type as shown below.

curl --request GET \
  --url https://api.1global.com/enterprise/recordings/rec_01KYM5N50HK0FX8M8DZHPH4RHY \
  --header 'Authorization: Bearer <ACCESS_TOKEN>' \
  --header 'Accept: application/json'

Example Response

The successful response returns with a 200 status code and the content of the measaasge for the specified recording_id.

{
    "id": "rec_01KYM5N50HK0FX8M8DZHPH4RHY",
    "from": "+44123456789",
    "to": "+44987654321",
    "recorded_at": "2026-07-01T11:14:19Z",
    "content": "This message is being recorded.",
    "_embedded": {
        "account": {
            "id": "acc_01KYM5NBR97F5H593GCBC91V2S",
            "_links": {
                "self": {
                    "href": "https://api.1global.com/enterprise/accounts/acc_01HTQ8VBN4DEJP5S8BPV4657VG",
                    "method": "GET"
                }
            }
        },
        "subscription": {
            "id": "sub_01HTJA47C93ABKKR58T05JBAJB",
            "_links": {
                "self": {
                    "href": "https://api.1global.com/enterprise/subscriptions/sub_01HTJA47C93ABKKR58T05JBAJB",
                    "method": "GET"
                }
            }
        }
    },
    "_links": {
        "self": {
            "href": "https://api.1global.com/enterprise/recordings/rec_01KYM5N50HK0FX8M8DZHPH4RHY",
            "method": "GET"
        }
    }
}