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

# List attribution links

> List creator attribution links

Use this endpoint to list attribution links created by the current creator. List endpoints use cursor pagination: `limit` defaults to `25` and cannot exceed `100`; pass the previous response's `next_cursor` as `cursor` to read the next page. When there are no more results, `next_cursor` is `null`.

Link fields:

* `id`: Attribution link ID.
* `brand_id`: Brand ID.
* `product_id`: Product ID.
* `url`: Shareable attribution link URL.
* `destination_url`: Amazon landing page URL, usually the product detail page or the requested destination.
* `marketplace`: Amazon marketplace domain for the attribution link, such as `amazon.com`, `amazon.co.uk`, or `amazon.de`. It identifies the link's Amazon site; it is not a partnership status or tracking tag.
* `tracking_id`: Client-side tracking tag supplied when the link was created; empty string when omitted. Future reports will use this field for downstream attribution.
* `status`: Link status. Because the underlying AttributionLink does not currently have a status field, this is always `active`.
* `created_at`: Link creation time.

Related operation: to create a new attribution link, use [Create attribution link](/en/creator/links/create-link).


## OpenAPI

````yaml GET /api/creator/v1/links
openapi: 3.1.0
info:
  title: OpenLight Public API
  version: 1.0.0
  summary: OpenLight seller and creator public API
  description: |
    Public API for external seller and creator integrations.
    Console/internal APIs remain documented separately in docs/openapi.yaml.
servers:
  - url: https://app.openlight.tech
    description: Production
  - url: http://localhost:8080
    description: Local development
security:
  - bearerAuth: []
tags:
  - name: Creator Brands
  - name: Creator Products
  - name: Creator Links
  - name: Creator Reports
  - name: Seller Brands
  - name: Seller Products
paths:
  /api/creator/v1/links:
    get:
      tags:
        - Creator Links
      summary: List creator attribution links
      description: >
        Returns attribution links created by the creator token owner, including
        the optional `tracking_id` originally supplied when each link was
        created and the Amazon `marketplace` domain associated with the link.
      operationId: listCreatorLinks
      parameters:
        - $ref: '#/components/parameters/Limit'
        - $ref: '#/components/parameters/Cursor'
      responses:
        '200':
          description: Creator links
          content:
            application/json:
              schema:
                type: object
                required:
                  - links
                  - next_cursor
                properties:
                  links:
                    type: array
                    description: 归因链接列表。List of attribution links.
                    items:
                      $ref: '#/components/schemas/PublicLink'
                  next_cursor:
                    $ref: '#/components/schemas/NextCursor'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
components:
  parameters:
    Limit:
      name: limit
      in: query
      required: false
      description: >-
        每页返回数量，默认 25，最大 100。Number of items per page; defaults to 25 and maxes
        out at 100.
      schema:
        type: integer
        default: 25
        maximum: 100
    Cursor:
      name: cursor
      in: query
      required: false
      description: 上一页响应返回的下一页游标。Cursor returned as `next_cursor` by the previous page.
      schema:
        type: string
  schemas:
    PublicLink:
      type: object
      required:
        - id
        - brand_id
        - product_id
        - url
        - destination_url
        - marketplace
        - tracking_id
        - status
        - created_at
      properties:
        id:
          type: string
          description: 归因链接 ID。Attribution link ID.
        brand_id:
          type: string
          description: 品牌 ID。Brand ID.
        product_id:
          type: string
          description: 商品 ID。Product ID.
        url:
          type: string
          description: 可分发的归因链接 URL。Shareable attribution link URL.
        destination_url:
          type: string
          description: >-
            Amazon 落地页 URL，通常为商品详情页或创建链接时传入的目标页。Amazon landing page URL, usually
            the product detail page or the requested destination.
        marketplace:
          type: string
          description: >-
            归因链接对应的 Amazon 站点域名，例如 amazon.com、amazon.co.uk、amazon.de；不是合作状态或追踪
            tag。Amazon marketplace domain for this attribution link, such as
            amazon.com, amazon.co.uk, or amazon.de; not a partnership status or
            tracking tag.
        tracking_id:
          type: string
          description: >-
            创建链接时传入并规范化后的客户侧追踪标识；未传入时为空字符串。Normalized client-side tracking tag
            supplied at creation time; empty string when omitted.
        status:
          type: string
          description: 链接状态；当前固定为 active。Link status; currently always active.
          enum:
            - active
        created_at:
          type: string
          format: date-time
          description: 链接创建时间。Link creation time.
    NextCursor:
      type:
        - string
        - 'null'
      description: >-
        下一页游标；为 null 表示没有更多结果。Cursor for the next page; null means there are no
        more results.
    PublicErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          description: 错误详情。Error detail.
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: 机器可读错误码。Machine-readable error code.
              examples:
                - invalid_api_token
                - forbidden_resource
            message:
              type: string
              description: 面向开发者的错误说明。Developer-facing error message.
  responses:
    BadRequest:
      description: Invalid request or pagination parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicErrorResponse'
          examples:
            invalid_request:
              summary: Invalid request
              value:
                error:
                  code: invalid_request
                  message: invalid_request
            invalid_pagination:
              summary: Invalid pagination
              value:
                error:
                  code: invalid_pagination
                  message: invalid_pagination
    Unauthorized:
      description: Missing or invalid API token
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicErrorResponse'
    Forbidden:
      description: Token cannot access the requested role or resource
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PublicErrorResponse'
          examples:
            forbidden_resource:
              summary: Forbidden resource
              value:
                error:
                  code: forbidden_resource
                  message: forbidden_resource
            ads_not_connected:
              summary: Ads not connected
              value:
                error:
                  code: ads_not_connected
                  message: ads_not_connected
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````