---
title: "GET /api/product-mapping/link/{linkId}"
method: GET
path: "/api/product-mapping/link/{linkId}"
tags: ["Product Mapping"]
---

# GET /api/product-mapping/link/{linkId}

`GET /api/product-mapping/link/{linkId}`

Get supply chain link by id

## Path parameters

- `linkId` string, required

## Query parameters

- `supplyChainId` string, required

## Response `200`

Default Response

- object
  - `metadata` object, required
    - `success` boolean, required — True when the request succeeded.
  - `data` object, required
    - `id` string, required
    - `originTracingNodeId` string, nullable
    - `destinationTracingNodeId` string, nullable
    - `isOriginCountry` union
      - number
      - boolean
    - `isInternal` union
      - number
      - boolean
    - `isReceiving` union
      - number
      - boolean
    - `isConnected` union
      - number
      - boolean
    - `level` number, nullable
    - `originTracingNode` object, nullable
      - `id` string, required
      - `assetCountry` string, nullable
      - `assetCountryName` string, nullable
      - `assetId` string, nullable
      - `assetType` string, nullable
      - `facilityProcesses` string[], nullable
      - `featuredFacilityProcess` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `productionProcessId` string, nullable
        - `productionProcessName` string, nullable
        - `productionProcessDescription` string, nullable
        - `productionProcessPosition` number, nullable
        - `productionProcessIconBackgroundColor` string, nullable
        - `productionProcessIconColor` string, nullable
        - `productionProcessDepthLevel` number, nullable
      - `featuredFacilityProcessName` string, nullable
      - `productionProcess` string, nullable
      - `producingProducts` object[], nullable
        - `id` string, required
        - `forCompanyId` string, nullable
        - `name` string, nullable
        - `description` string, nullable
        - `gender` string, nullable
        - `productCategoryId` string, nullable
        - `isStoryActive` number, nullable
        - `isArchived` number, nullable
        - `isComponent` number, nullable
        - `imagesFileIds` string, nullable
        - `qrCodeId` string, nullable
        - `qrCodeUrl` string, nullable
        - `qrCodeContentType` string, nullable
        - `materials` object[]
        - `totalMaterialWeight` number, nullable
        - `createdAt` union
          - string
          - string, date-time
        - `updatedAt` union
          - string
          - string, date-time
        - `codes` object[], required
          - `codeId` string, required — Identifier type for the code. Single-use (each may appear at most once): ERP_ID, PLM_ID, MAIN_SUPPLIERS_ID, PIM_ID, UPC_GTIN_12, EAN_GTIN_13, ZALANDO_ID, FASHIONCLOUD_ID. Multi-use (append a numeric suffix for additional entries, e.g. OTHER_ID1, OTHER_ID2): OTHER_ID, ALTERNATIVE_SUPPLIERS_ID.
          - `codeValue` string, required — The unique code value for this identifier, e.g. "ERP-001234".
        - `productCategoryName` string, nullable
        - `productCategoryQuantityUnits` string[]
        - `productCategoryWeightUnits` string[]
        - `productLevelName` string, nullable
        - `productLevelQuantityUnits` string[]
        - `productLevelId` string, nullable
        - `productLevelWeightUnits` string[]
        - `styleTypeName` string, nullable
        - `styleLevelName` string, nullable
        - `isWeightAvailable` union
          - number
          - boolean
        - `categoryFieldValues` object[]
          - `id` string
          - `styleCategoryFieldId` string
          - `fieldName` string, required
          - `fieldType` string, required
          - `fieldValue` union
            - string
            - number
            - boolean
            - string[]
            - object
              - …
          - `standardFieldName` string, nullable
          - `fieldOptions` union
            - string
            - string[]
            - object
        - `productProperties` object
          - `brands` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `seasons` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `departments` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `collections` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
        - `externalProductTypes` object[]
        - `unit` string, nullable
        - `quantity` number, nullable
        - `secondaryQuantity` number, nullable
        - `secondaryUnit` string, nullable
        - `lineId` string, nullable
        - `productLevel` string, nullable
      - `asset` object, nullable
        - `id` string, required
        - `officialName` string, nullable
        - `name` string, nullable
        - `isRemoved` union
          - number
          - boolean
        - `workosOrganizationId` string, nullable
        - `featuredImageFileId` string, nullable
        - `featuredImageFileUrl` string, nullable
        - `originalFeaturedImageFileUrl` string, nullable
        - `videoFileId` string, nullable
        - `videoFileUrl` string, nullable
        - `originalVideoFileUrl` string, nullable
        - `imageList` object[], nullable
          - `url` string, nullable
          - `originalUrl` string, nullable
        - `country` string, nullable
        - `countryName` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `currency` string, nullable
        - `zipCode` string, nullable
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `phone` string, nullable
        - `website` string, nullable
        - `geojson` string, nullable
        - `description` string, nullable
        - `facilityProcesses` string, nullable
        - `numOfPermanentEmployees` number, nullable
        - `numOfMaleEmployees` number, nullable
        - `numOfFemaleEmployees` number, nullable
        - `annualProductionCapacity` number, nullable
        - `annualProductionCapacityUnit` string, nullable
        - `minimumOrderQuantity` number, nullable
        - `minimumOrderQuantityPerStyle` number, nullable
        - `standardLeadTime` number, nullable
        - `founders` string, nullable
        - `founded` number, nullable
        - `companySize` string, nullable
        - `companyType` string, nullable
        - `shopId` string, nullable
        - `higgId` string, nullable
        - `globalLocationNumber` string, nullable
        - `vatId` string, nullable
        - `dunsNumber` string, nullable
        - `commercialRegisterNumber` string, nullable
        - `osHubId` string, nullable
        - `isDemoCompany` union
          - number
          - boolean
        - `isClientCompany` union
          - number
          - boolean
        - `transliteratedOfficialName` string, nullable
        - `transliteratedName` string, nullable
        - `collaborationStartDate` union
          - string
          - string, date-time
        - `connectionType` string, nullable
        - `relationshipType` unknown
        - `collaborationStatus` unknown
        - `createdAt` union
          - string
          - string, date-time
        - `updatedAt` union
          - string
          - string, date-time
      - `collaboratorStatus` 'OWNER' | 'INVITED' | 'ACCEPTED', nullable
      - `permissions` string[]
      - `collaborator` object, nullable
        - `id` string, required
        - `collaborationType` string, required
        - `collaborationStatus` string, nullable
        - `fromCollaboratorId` string, required
        - `invitedByCompanyId` string, nullable
        - `tracingNodeId` string, nullable
        - `createdAt` union
          - string
          - string, date-time
        - `createdByUserId` string, nullable
        - `createdByCompanyId` string, nullable
        - `company` object, nullable
          - `id` string, required
          - `officialName` string, nullable
          - `name` string, nullable
          - `country` string, nullable
          - `isRemoved` union
            - number
            - boolean
          - `featuredImageFileId` string, nullable
        - `status` string, nullable
        - `message` string, nullable
      - `isParentNode` boolean
      - `isStartingNode` boolean
    - `destinationTracingNode` object, nullable
      - `id` string, required
      - `assetCountry` string, nullable
      - `assetCountryName` string, nullable
      - `assetId` string, nullable
      - `assetType` string, nullable
      - `facilityProcesses` string[], nullable
      - `featuredFacilityProcess` object, nullable
        - `id` string, required
        - `name` string, nullable
        - `productionProcessId` string, nullable
        - `productionProcessName` string, nullable
        - `productionProcessDescription` string, nullable
        - `productionProcessPosition` number, nullable
        - `productionProcessIconBackgroundColor` string, nullable
        - `productionProcessIconColor` string, nullable
        - `productionProcessDepthLevel` number, nullable
      - `featuredFacilityProcessName` string, nullable
      - `productionProcess` string, nullable
      - `producingProducts` object[], nullable
        - `id` string, required
        - `forCompanyId` string, nullable
        - `name` string, nullable
        - `description` string, nullable
        - `gender` string, nullable
        - `productCategoryId` string, nullable
        - `isStoryActive` number, nullable
        - `isArchived` number, nullable
        - `isComponent` number, nullable
        - `imagesFileIds` string, nullable
        - `qrCodeId` string, nullable
        - `qrCodeUrl` string, nullable
        - `qrCodeContentType` string, nullable
        - `materials` object[]
        - `totalMaterialWeight` number, nullable
        - `createdAt` union
          - string
          - string, date-time
        - `updatedAt` union
          - string
          - string, date-time
        - `codes` object[], required
          - `codeId` string, required — Identifier type for the code. Single-use (each may appear at most once): ERP_ID, PLM_ID, MAIN_SUPPLIERS_ID, PIM_ID, UPC_GTIN_12, EAN_GTIN_13, ZALANDO_ID, FASHIONCLOUD_ID. Multi-use (append a numeric suffix for additional entries, e.g. OTHER_ID1, OTHER_ID2): OTHER_ID, ALTERNATIVE_SUPPLIERS_ID.
          - `codeValue` string, required — The unique code value for this identifier, e.g. "ERP-001234".
        - `productCategoryName` string, nullable
        - `productCategoryQuantityUnits` string[]
        - `productCategoryWeightUnits` string[]
        - `productLevelName` string, nullable
        - `productLevelQuantityUnits` string[]
        - `productLevelId` string, nullable
        - `productLevelWeightUnits` string[]
        - `styleTypeName` string, nullable
        - `styleLevelName` string, nullable
        - `isWeightAvailable` union
          - number
          - boolean
        - `categoryFieldValues` object[]
          - `id` string
          - `styleCategoryFieldId` string
          - `fieldName` string, required
          - `fieldType` string, required
          - `fieldValue` union
            - string
            - number
            - boolean
            - string[]
            - object
              - …
          - `standardFieldName` string, nullable
          - `fieldOptions` union
            - string
            - string[]
            - object
        - `productProperties` object
          - `brands` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `seasons` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `departments` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `collections` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
        - `externalProductTypes` object[]
        - `unit` string, nullable
        - `quantity` number, nullable
        - `secondaryQuantity` number, nullable
        - `secondaryUnit` string, nullable
        - `lineId` string, nullable
        - `productLevel` string, nullable
      - `asset` object, nullable
        - `id` string, required
        - `officialName` string, nullable
        - `name` string, nullable
        - `isRemoved` union
          - number
          - boolean
        - `workosOrganizationId` string, nullable
        - `featuredImageFileId` string, nullable
        - `featuredImageFileUrl` string, nullable
        - `originalFeaturedImageFileUrl` string, nullable
        - `videoFileId` string, nullable
        - `videoFileUrl` string, nullable
        - `originalVideoFileUrl` string, nullable
        - `imageList` object[], nullable
          - `url` string, nullable
          - `originalUrl` string, nullable
        - `country` string, nullable
        - `countryName` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `currency` string, nullable
        - `zipCode` string, nullable
        - `addressLine1` string, nullable
        - `addressLine2` string, nullable
        - `phone` string, nullable
        - `website` string, nullable
        - `geojson` string, nullable
        - `description` string, nullable
        - `facilityProcesses` string, nullable
        - `numOfPermanentEmployees` number, nullable
        - `numOfMaleEmployees` number, nullable
        - `numOfFemaleEmployees` number, nullable
        - `annualProductionCapacity` number, nullable
        - `annualProductionCapacityUnit` string, nullable
        - `minimumOrderQuantity` number, nullable
        - `minimumOrderQuantityPerStyle` number, nullable
        - `standardLeadTime` number, nullable
        - `founders` string, nullable
        - `founded` number, nullable
        - `companySize` string, nullable
        - `companyType` string, nullable
        - `shopId` string, nullable
        - `higgId` string, nullable
        - `globalLocationNumber` string, nullable
        - `vatId` string, nullable
        - `dunsNumber` string, nullable
        - `commercialRegisterNumber` string, nullable
        - `osHubId` string, nullable
        - `isDemoCompany` union
          - number
          - boolean
        - `isClientCompany` union
          - number
          - boolean
        - `transliteratedOfficialName` string, nullable
        - `transliteratedName` string, nullable
        - `collaborationStartDate` union
          - string
          - string, date-time
        - `connectionType` string, nullable
        - `relationshipType` unknown
        - `collaborationStatus` unknown
        - `createdAt` union
          - string
          - string, date-time
        - `updatedAt` union
          - string
          - string, date-time
      - `collaboratorStatus` 'OWNER' | 'INVITED' | 'ACCEPTED', nullable
      - `permissions` string[]
      - `collaborator` object, nullable
        - `id` string, required
        - `collaborationType` string, required
        - `collaborationStatus` string, nullable
        - `fromCollaboratorId` string, required
        - `invitedByCompanyId` string, nullable
        - `tracingNodeId` string, nullable
        - `createdAt` union
          - string
          - string, date-time
        - `createdByUserId` string, nullable
        - `createdByCompanyId` string, nullable
        - `company` object, nullable
          - `id` string, required
          - `officialName` string, nullable
          - `name` string, nullable
          - `country` string, nullable
          - `isRemoved` union
            - number
            - boolean
          - `featuredImageFileId` string, nullable
        - `status` string, nullable
        - `message` string, nullable
      - `isParentNode` boolean
      - `isStartingNode` boolean
    - `lines` object[]
      - `id` string, required
      - `tracingLinkId` string, required
      - `styleId` string, required
      - `quantity` number, nullable
      - `unit` string, nullable
      - `secondaryQuantity` number, nullable
      - `secondaryUnit` string, nullable
      - `style` object, nullable
        - `id` string, required
        - `forCompanyId` string, nullable
        - `name` string, nullable
        - `description` string, nullable
        - `gender` string, nullable
        - `productCategoryId` string, nullable
        - `isStoryActive` number, nullable
        - `isArchived` number, nullable
        - `isComponent` number, nullable
        - `imagesFileIds` string, nullable
        - `qrCodeId` string, nullable
        - `qrCodeUrl` string, nullable
        - `qrCodeContentType` string, nullable
        - `materials` object[]
        - `totalMaterialWeight` number, nullable
        - `createdAt` union
          - string
          - string, date-time
        - `updatedAt` union
          - string
          - string, date-time
        - `codes` object[], required
          - `codeId` string, required — Identifier type for the code. Single-use (each may appear at most once): ERP_ID, PLM_ID, MAIN_SUPPLIERS_ID, PIM_ID, UPC_GTIN_12, EAN_GTIN_13, ZALANDO_ID, FASHIONCLOUD_ID. Multi-use (append a numeric suffix for additional entries, e.g. OTHER_ID1, OTHER_ID2): OTHER_ID, ALTERNATIVE_SUPPLIERS_ID.
          - `codeValue` string, required — The unique code value for this identifier, e.g. "ERP-001234".
        - `productCategoryName` string, nullable
        - `productCategoryQuantityUnits` string[]
        - `productCategoryWeightUnits` string[]
        - `productLevelName` string, nullable
        - `productLevelQuantityUnits` string[]
        - `productLevelId` string, nullable
        - `productLevelWeightUnits` string[]
        - `styleTypeName` string, nullable
        - `styleLevelName` string, nullable
        - `isWeightAvailable` union
          - number
          - boolean
        - `categoryFieldValues` object[]
          - `id` string
          - `styleCategoryFieldId` string
          - `fieldName` string, required
          - `fieldType` string, required
          - `fieldValue` union
            - string
            - number
            - boolean
            - string[]
            - object
              - …
          - `standardFieldName` string, nullable
          - `fieldOptions` union
            - string
            - string[]
            - object
        - `productProperties` object
          - `brands` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `seasons` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `departments` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
          - `collections` object[]
            - `id` string, required
            - `value` string, required
            - `category` string, required
            - `forCompanyId` string, required
        - `externalProductTypes` object[]
    - `createdAt` union
      - string
      - string, date-time
    - `createdByImpersonateId` string, nullable
    - `createdByUserId` string, nullable
    - `createdByCompanyId` string, nullable
    - `createdByApiKeyId` string, nullable
    - `createdByApiKeyLabel` string, nullable
    - `updatedAt` union
      - string
      - string, date-time
    - `updatedByImpersonateId` string, nullable
    - `updatedByImpersonateName` string, nullable
    - `updatedByUserId` string, nullable
    - `updatedByUserName` string, nullable
    - `updatedByCompanyId` string, nullable
    - `updatedByCompanyName` string, nullable
    - `updatedByApiKeyId` string, nullable
    - `updatedByApiKeyLabel` string, nullable

## Other responses

- `401` — Default Response
- `403` — Default Response
- `404` — Default Response

## Changes

> 23 revisions in range; 1 not diffed.

- **2026-08-31** `97e51f27dc77` — 32 breaking, 98 info
  - the response property `data/createdAt` became nullable for the status `200`
  - the response property `data/createdByApiKeyId` became nullable for the status `200`
  - the response property `data/createdByApiKeyLabel` became nullable for the status `200`
  - the response property `data/createdByCompanyId` became nullable for the status `200`
  - …126 more
- **2026-08-21** `ae0f0a740727` — 4 info
  - added the optional property `data/destinationTracingNode/anyOf[subschema #1]/asset/anyOf[subschema #1]/isRemoved` to the response with the `200` status
  - added the optional property `data/destinationTracingNode/anyOf[subschema #1]/collaborator/anyOf[subschema #1]/company/anyOf[subschema #1]/isRemoved` to the response with the `200` status
  - added the optional property `data/originTracingNode/anyOf[subschema #1]/asset/anyOf[subschema #1]/isRemoved` to the response with the `200` status
  - added the optional property `data/originTracingNode/anyOf[subschema #1]/collaborator/anyOf[subschema #1]/company/anyOf[subschema #1]/isRemoved` to the response with the `200` status

[Change history](https://skmtc.dev/retraced/apis/api-reference/changes/api/product-mapping/link/:linkId/get.md)

---

[API](https://skmtc.dev/retraced/apis/api-reference.md) · [All operations](https://skmtc.dev/retraced/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/retraced/api-reference/revisions/fde251beb0ca/schema)
