Skip to main content
Released 14th October 2026

Partner reference on message read endpoints

A new partner_ref field has been added to the response item schemas of the GET /v2/telematics/group-messages and GET /v2/telematics/messages endpoints. This field surfaces the partner-side reference identifier that was previously only available on write operations, making it straightforward to correlate Catena message records with objects in your own system when reading data back. The change is additive and backward-compatible — existing requests continue to behave exactly as before.
Backward-compatible addition: The new partner_ref field is purely additive. No existing integrations are affected.

New field

Affected endpoints

Each item in the items array of the 200 response now includes a partner_ref field.
Example response item excerpt:
Each item in the items array of the 200 response now includes a partner_ref field.

Need help?

API reference

View complete endpoint documentation for the Telematics API

Contact support

Questions about your integration? Our team is here to help