> ## Documentation Index > Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt > Use this file to discover all available pages before exploring further. # ๐Ÿงช Get Load Connection Links > Retrieve the connections the carrier identifiers you sent matched for a load you posted. Connections are linked from the carrier identifiers on the load (`dot`, `scac`, `mc`), and `matched_on` lists every identifier the connection agrees with. If an identifier fits several connections, all of them are returned, best match first. A load that matched no connection has an empty list, which means the carrier is unknown, not that it has no telematics. Only active connections of fleets that share vehicle data with you are returned. **Provisional endpoint**\ This endpoint is available for early access. The core schema is stable, but minor details โ€” such as field names or added fields โ€” may change before it becomes generally available. Backward compatibility is not guaranteed.\ \ *See [API Stability & Versioning](/api-reference/stability-versioning) for details on provisional endpoints.* ## OpenAPI ````yaml https://api.catenatelematics.com/v2/intelligence/openapi.json get /v2/visibility/loads/{load_id}/connection-links openapi: 3.1.0 info: title: Telematics Intelligence Service - REST API description: Telematics Intelligence Service REST API. version: 0.1.0 servers: - url: https://api.catenatelematics.com description: Catena Intelligence API security: [] tags: - name: Analytics description: >- Endpoints providing analytical insights and aggregated data for vehicles, fleets, drivers, and trailers. - name: Benchmarks description: >- Endpoints providing cross-fleet benchmark data. A vehicle's metrics are ranked against a cohort of peer vehicles drawn from the full Catena fleet population. Cohort statistics are k-anonymised: percentile and cohort counts are suppressed when the cohort covers too few distinct fleets to protect individual fleet privacy. - name: Visibility description: >- Post load context, including planned locations, times, and the carrier, vehicle and driver. paths: /v2/visibility/loads/{load_id}/connection-links: get: tags: - Visibility summary: Get connection links for a load description: >- Retrieve the connections the carrier identifiers you sent matched for a load you posted. Connections are linked from the carrier identifiers on the load (`dot`, `scac`, `mc`), and `matched_on` lists every identifier the connection agrees with. If an identifier fits several connections, all of them are returned, best match first. A load that matched no connection has an empty list, which means the carrier is unknown, not that it has no telematics. Only active connections of fleets that share vehicle data with you are returned. operationId: get_load_connection_links parameters: - name: load_id in: path required: true schema: type: string format: uuid title: Load Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/LoadConnectionLinksRead' '400': content: application/json: schema: $ref: '#/components/schemas/BadRequest' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/Unauthorized' description: Unauthorized '403': content: application/json: schema: $ref: '#/components/schemas/Forbidden' description: Forbidden '404': content: application/json: schema: $ref: '#/components/schemas/NotFound' description: Not Found '405': content: application/json: schema: $ref: '#/components/schemas/MethodNotAllowed' description: Method Not Allowed '409': content: application/json: schema: $ref: '#/components/schemas/Conflict' description: Conflict '422': content: application/json: schema: $ref: '#/components/schemas/UnprocessableEntity' description: Unprocessable Entity '429': content: application/json: schema: $ref: '#/components/schemas/TooManyRequests' description: Too Many Requests '500': content: application/json: schema: $ref: '#/components/schemas/InternalServerError' description: Internal Server Error '501': content: application/json: schema: $ref: '#/components/schemas/NotImplementedResponse' description: Not Implemented security: - Bearer: - telematics:read components: schemas: LoadConnectionLinksRead: properties: load_id: type: string format: uuid title: Load Id description: Catena identifier of the load. load_ref: type: string title: Load Ref description: Your reference for the load, as posted. links: items: $ref: '#/components/schemas/LoadConnectionLinkRead' type: array title: Links description: >- Connections the load's carrier identifiers matched, best match first. Empty when the load is not linked: no carrier identifier matched a connection you can see, or the load has not been linked yet. More than one when an identifier fits several connections. type: object required: - load_id - load_ref - links title: LoadConnectionLinksRead description: >- Connections linked to a load from the carrier identifiers its partner sent. BadRequest: properties: code: type: integer title: Code default: 400 message: type: string title: Message default: Bad Request detail: anyOf: - type: string - type: 'null' title: Detail type: object title: BadRequest Unauthorized: properties: code: type: integer title: Code default: 401 message: type: string title: Message default: Unauthorized detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Unauthorized Forbidden: properties: code: type: integer title: Code default: 403 message: type: string title: Message default: Forbidden detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Forbidden NotFound: properties: code: type: integer title: Code default: 404 message: type: string title: Message default: Not Found detail: anyOf: - type: string - type: 'null' title: Detail type: object title: NotFound MethodNotAllowed: properties: code: type: integer title: Code default: 405 message: type: string title: Message default: Method Not Allowed detail: anyOf: - type: string - type: 'null' title: Detail type: object title: MethodNotAllowed Conflict: properties: code: type: integer title: Code default: 409 message: type: string title: Message default: Conflict detail: anyOf: - type: string - type: 'null' title: Detail type: object title: Conflict UnprocessableEntity: properties: code: type: integer title: Code default: 422 message: type: string title: Message default: Invalid Request Body detail: anyOf: - items: $ref: '#/components/schemas/ValidationErrorDetail' type: array - type: 'null' title: Detail type: object title: UnprocessableEntity TooManyRequests: properties: code: type: integer title: Code default: 429 message: type: string title: Message default: Too Many Requests detail: anyOf: - $ref: '#/components/schemas/RetryAfterDetail' - type: 'null' type: object title: TooManyRequests InternalServerError: properties: message: type: string title: Message default: Internal Server Error type: object title: InternalServerError NotImplementedResponse: properties: code: type: integer title: Code default: 501 message: type: string title: Message default: Not Implemented detail: anyOf: - type: string - type: 'null' title: Detail type: object title: NotImplementedResponse LoadConnectionLinkRead: properties: connection_id: type: string format: uuid title: Connection Id description: >- Catena identifier of the connection, a fleet/TSP pairing, as it appears on telematics records. matched_on: items: $ref: '#/components/schemas/ConnectionMatchFieldEnum' type: array title: Matched On description: >- The carrier identifiers on the load that this connection agrees with: `dot`, `scac` and `mc`. confidence: type: string title: Confidence description: >- How far to trust the link. `high` is the only value today; weaker tiers may be added. type: object required: - connection_id - matched_on - confidence title: LoadConnectionLinkRead description: One connection the carrier identifiers on the load matched. ValidationErrorDetail: properties: path: type: string title: Path input: type: string title: Input message: type: string title: Message error_type: type: string title: Error Type type: object required: - path - input - message - error_type title: ValidationErrorDetail RetryAfterDetail: properties: retry_after_seconds: type: integer title: Retry After Seconds message: type: string title: Message type: object required: - retry_after_seconds - message title: RetryAfterDetail ConnectionMatchFieldEnum: type: string enum: - dot - scac - mc title: ConnectionMatchFieldEnum description: >- A carrier identifier a load can be linked to a connection on. Only `dot` can be matched today: nothing on the connection side carries a SCAC or MC number yet. securitySchemes: Bearer: type: oauth2 flows: clientCredentials: refreshUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token scopes: {} tokenUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token authorizationCode: refreshUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token scopes: {} authorizationUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/auth tokenUrl: >- https://auth.catenatelematics.com/realms/catena/protocol/openid-connect/token ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.