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

# List Tracked Links

> List an asset's tracked links: who each was made for, its contact and deal, how many real outside views it has had and when it was last opened, and where its opens are announced. Views from the workspace and from email scanners are not counted.



## OpenAPI

````yaml get /api/v2/asset/tracked-links/list
openapi: 3.0.0
info:
  version: 7.2.0
  title: Octave API
  description: API for Octave workspace management and AI-powered content generation
servers:
  - url: https://app.octavehq.com
security:
  - ApiKeyAuth: []
paths:
  /api/v2/asset/tracked-links/list:
    get:
      tags:
        - Asset
      summary: List Tracked Links
      description: >-
        List an asset's tracked links: who each was made for, its contact and
        deal, how many real outside views it has had and when it was last
        opened, and where its opens are announced. Views from the workspace and
        from email scanners are not counted.
      operationId: listTrackedLinks
      parameters:
        - schema:
            type: string
            minLength: 1
            description: UUID of the asset. e.g. '4f1e2a90-8b3d-4c21-9e07-2a1b3c4d5e6f'
          required: true
          description: UUID of the asset. e.g. '4f1e2a90-8b3d-4c21-9e07-2a1b3c4d5e6f'
          name: assetId
          in: query
      responses:
        '200':
          description: Tracked links listed successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/Metadata'
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        oId:
                          type: string
                        assetId:
                          type: string
                        shareUuid:
                          type: string
                        url:
                          type: string
                          nullable: true
                        recipientName:
                          type: string
                        opportunity:
                          type: object
                          nullable: true
                          properties:
                            oId:
                              type: string
                            name:
                              type: string
                          required:
                            - oId
                            - name
                        notifyOn:
                          type: string
                          enum:
                            - first_view
                            - every_view
                            - 'off'
                        notifyTargets:
                          type: object
                          properties:
                            slack:
                              type: object
                              nullable: true
                              properties:
                                channel:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                      minLength: 1
                                    name:
                                      type: string
                                      minLength: 1
                                  required:
                                    - id
                                    - name
                              default: null
                              required:
                                - channel
                            slackDm:
                              type: object
                              nullable: true
                              properties:
                                recipients:
                                  type: array
                                  items:
                                    type: string
                                    maxLength: 254
                                    format: email
                                  minItems: 1
                                  maxItems: 20
                              default: null
                              required:
                                - recipients
                            email:
                              type: object
                              nullable: true
                              properties:
                                recipients:
                                  type: array
                                  items:
                                    type: string
                                    maxLength: 254
                                    format: email
                                  minItems: 1
                                  maxItems: 20
                              default: null
                              required:
                                - recipients
                        viewCount:
                          type: number
                        firstViewedAt:
                          type: string
                          nullable: true
                        lastViewedAt:
                          type: string
                          nullable: true
                        createdBy:
                          type: object
                          nullable: true
                          properties:
                            oId:
                              type: string
                            name:
                              type: string
                          required:
                            - oId
                            - name
                        createdAt:
                          type: string
                      required:
                        - oId
                        - assetId
                        - shareUuid
                        - url
                        - recipientName
                        - opportunity
                        - notifyOn
                        - notifyTargets
                        - viewCount
                        - firstViewedAt
                        - lastViewedAt
                        - createdBy
                        - createdAt
                  total:
                    type: number
                required:
                  - _metadata
                  - data
                  - total
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  _metadata:
                    $ref: '#/components/schemas/Metadata'
                required:
                  - _metadata
      deprecated: false
components:
  schemas:
    Metadata:
      type: object
      properties:
        usage:
          type: number
          default: 0
          example: 0
          description: API usage
        requestId:
          type: string
          example: requestId
          description: Request ID
        message:
          type: string
          example: message
          description: Message
        timestamp:
          type: string
          example: '2021-01-01T00:00:00.000Z'
          description: Timestamp
      required:
        - requestId
        - timestamp
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api_key

````

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