Skip to main content
GET
Get Share Agreement

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

share_agreement_id
string<uuid>
required

Response

Successful Response

API model for reading a sharing agreement

Contains all the details about what data you can access from a fleet. Monitor the status field to track active agreements.

id
string<uuid>
required

Unique agreement identifier

fleet_id
string<uuid>
required

The Catena fleet ID sharing their data with you

partner_id
string<uuid>
required

Your organization ID receiving access to fleet data

fleet_ref
string | null
required

Your internal fleet identifier for mapping Catena fleets to your system. Returned in webhooks and APIs for easy integration.

status
enum<string>
required

Current state: ACTIVE (data access enabled), PAUSED (temporarily disabled), CANCELLED (permanently ended), EXPIRED (past expiration_date)

Available options:
active,
paused,
cancelled,
deleted,
expired
effective_date
string<date-time>
required

When data access begins. Check this before attempting to fetch fleet data.

expiration_date
string<date-time> | null
required

When data access ends. Null means no expiration. Status automatically changes to EXPIRED after this date.

scopes
Shared Scopes · object
required

Defines which resources (vehicle, locations, users, etc.) you can access and the permission level (read, write) for each.