> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aiyoti.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a shared asset

> Retrieves asset data using `AssetShareID` in the query string. No AccessKey is required. The response includes current and destination addresses, tracking information, asset status, exception labels, and location history. It returns an empty object when no matching sharing record exists. Unlike Get asset, this response omits AssetID. Exceptions is an array of labels.



## OpenAPI

````yaml /openapi/openapi.json get /Assets/GetSharing
openapi: 3.1.0
info:
  title: Aiyoti Integration API Basic
  description: Create, retrieve, update, and manage the tracking lifecycle of assets.
  version: 0.0.1
servers:
  - url: https://api.aiyoticloud.com
security: []
tags:
  - name: Users
    description: Log in and refresh credentials.
  - name: Carriers
    description: Look up the carriers available to an account.
  - name: Labels
    description: Look up the labels available for new assets.
  - name: Assets / Shipments
    description: Create, list, retrieve, edit, annotate, and delete assets.
paths:
  /Assets/GetSharing:
    get:
      tags:
        - Assets / Shipments
      summary: Get a shared asset
      description: >-
        Retrieves asset data using `AssetShareID` in the query string. No
        AccessKey is required. The response includes current and destination
        addresses, tracking information, asset status, exception labels, and
        location history. It returns an empty object when no matching sharing
        record exists. Unlike Get asset, this response omits AssetID. Exceptions
        is an array of labels.
      operationId: get_sharing_Assets_GetSharing_get
      parameters:
        - name: AssetShareID
          in: query
          required: true
          schema:
            type: string
          description: >-
            Identifier granting access to a shared asset. Keep it private except
            when sharing with intended recipients.
          example: '00000000000000000000000000000006'
      responses:
        '200':
          description: >-
            Shared asset object, or an empty object for an unknown or deleted
            sharing identifier.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SharedAsset'
              example:
                AssetName: Example Shipment
                LabelID: null
                CarrierName: null
                StatusNo: 1
                Status: Created
                Exceptions: []
                Locations: []
        '400':
          description: >-
            Request rejected. Check your credentials, account access, and
            request parameters.
        '422':
          description: Request validation failed. Check required fields and value types.
      security: []
components:
  schemas:
    SharedAsset:
      type: object
      properties:
        LabelID:
          type:
            - integer
            - 'null'
          description: Label identifier; may be null.
        AssetName:
          type: string
          description: Name of the asset.
        lat:
          type:
            - number
            - 'null'
          description: Current latitude.
        lng:
          type:
            - number
            - 'null'
          description: Current longitude.
        TrackingNo:
          type:
            - string
            - 'null'
          description: Carrier tracking number.
        Address:
          type:
            - string
            - 'null'
          description: Current address.
        DestinationAddress:
          type:
            - string
            - 'null'
          description: Destination address.
        Description:
          type:
            - string
            - 'null'
          description: Asset description.
        CarrierName:
          type:
            - string
            - 'null'
          description: Carrier name; may be null.
        CreatedOn:
          type: string
          description: Asset creation timestamp.
        LastContact:
          type:
            - string
            - 'null'
          description: Last contact timestamp; may be null.
        StatusNo:
          type: integer
          description: Asset status value.
        ActivatedOn:
          type:
            - string
            - 'null'
          description: Asset activation timestamp; may be null.
        ExpirationDate:
          type:
            - string
            - 'null'
          description: Asset expiration timestamp, not sharing-link expiration.
        Status:
          type:
            - string
            - 'null'
          description: Asset status name.
        Exceptions:
          type: array
          items:
            type: string
          description: Exception labels; an empty array when none are set.
        Locations:
          type: array
          items:
            $ref: '#/components/schemas/AssetLocation'
          description: >-
            Location history, newest first. All entries are returned in one
            response.
      description: >-
        Shared asset data. An unknown or deleted sharing identifier returns an
        empty object. AssetID is not returned; Exceptions is an array of labels.
    AssetLocation:
      type: object
      properties:
        LocationTime:
          type: string
          description: Localized date and time.
        LocationTimeUTC:
          type: string
          description: UTC date and time.
        lat:
          type: number
          description: Latitude.
        lng:
          type: number
          description: Longitude.
        Address:
          type: string
          description: Address.
      description: One entry in an asset's location history.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.