Skip to main content

Get a product by its id

GET 

/partner/v1.0/organizations/:organizationId/products/:id

Get a product by its id

Request

Path Parameters

    organizationId stringrequired

    The ID of the organization in the Carbon Trail platform

    id stringrequired

    The ID of the product

Responses

OK

Schema

    id stringnullable

    The unique identifier of the product.

    productionTimestamp date-time

    The timestamp when the product was produced.

    category ProductCategory (string)

    Possible values: [Apparel, Footwear, Bags, Fabric, Home, Component, Sports Equipment]

    The category of the product.

    type stringnullable

    The type of the product.

    created date-time

    The timestamp when the product was created in the system.

    updated date-timenullable

    The timestamp when the product was last updated.

    name stringnullable

    The name of the product.

    articleNumber stringnullable

    The article number of the product.

    sku stringnullable

    The Stock Keeping Unit (SKU) of the product.

    materials

    object[]

    nullable

    The list of raw materials used in the product.

  • Array [

  • name stringnullable

    The name of the raw material.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    materialPercentageInComponent doublenullable

    The percentage of this material by weight in a component. For materials not used in a component, this is set to the weight distribution across the remainder of the product by weight.

    recyclingInformation

    object

    Represents recycling information for a material.

    recyclingPercentage double

    The percentage of the material that is recycled.

    recyclingSource stringnullable

    The source of the recycled material.

    recyclingCollection RecycledMaterialCollectionMethod (string)

    Possible values: [Pre-Consumer, Post-Consumer]

    The method of collecting the recycled material ///

    recyclingProcess RecycledMaterialProcessingMethod (string)

    Possible values: [Mechanical, Chemical, Chemical (Glycolysis), Chemical (Methanolysis)]

    The method of processing the recycled material

    hops

    object[]

    nullable

    The list of transport hops for this raw material.

  • Array [

  • sourceId stringnullable

    The ID of the source entity.

    destinationId stringnullable

    The ID of the destination entity.

    legs

    object[]

    nullable

    The individual transport legs between the source and destination.

  • Array [

  • utilizationRatio doublenullable

    The utilization ratio which represents the % of the transport mode that is utilized for moving the item.

    distanceInKms doublenullable

    The distance covered as part of this leg.

    mode TransportMode (string)

    Possible values: [Truck, Train, Van, Car, Barge, Ship, Plane]

    Represents the mode of transport. ///

  • ]

  • ]

  • certifications string[]nullable

    The list of certifications associated with this raw material.

  • ]

  • accessories

    object[]

    nullable

    The list of accessories associated with the product.

  • Array [

  • type stringnullable

    The type of the accessory.

    amount doublenullable

    The quantity or amount of the accessory.

    unit stringnullable

    The unit of measurement for the accessory amount.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

  • ]

  • packaging

    object

    The packaging material details of this product.

    materials

    object[]

    nullable

    The packaging materials used to pack this product.

  • Array [

  • material stringnullable

    The material used for packaging.

    type PackagingType (string)

    Possible values: [Primary, Secondary, Tertiary, Intermediate]

    The type of packaging. Primary indicates the material the product is first wrapped with (like polybag) Secondary indicates the secondary layer on top of the primary layer (like cardboard) Tertiary indicates things like pallets which are used in warehouses.

    weightInGms doublenullable

    The weight of the packaging material in grams.

    supplierId stringnullable

    The unique identifier of the supplier for this packaging material.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    recyclingInformation

    object

    Represents recycling information for a material.

    recyclingPercentage double

    The percentage of the material that is recycled.

    recyclingSource stringnullable

    The source of the recycled material.

    recyclingCollection RecycledMaterialCollectionMethod (string)

    Possible values: [Pre-Consumer, Post-Consumer]

    The method of collecting the recycled material ///

    recyclingProcess RecycledMaterialProcessingMethod (string)

    Possible values: [Mechanical, Chemical, Chemical (Glycolysis), Chemical (Methanolysis)]

    The method of processing the recycled material

  • ]

  • weightInGms doublenullable

    The weight of the product in grams.

    intrinsicValue doublenullable

    The intrinsic value of the product.

    organizationId stringnullable

    The unique identifier of the organization associated with the product.

    subsidiaryId stringnullable

    The unique identifier of the subsidiary associated with the product.

    certifications string[]nullable

    The list of certifications associated with the product.

    passportEnabled booleannullable

    Indicates whether the product is passport enabled.

    status EntityStatus (string)

    Possible values: [Active, Snapshot, Draft, Submitted, Template]

    The status of the entity in the Carbon Trail platform.

    components

    object[]

    nullable

    The list of components that make up the product.

  • Array [

  • id stringnullable

    The unique identifier of the component.

    type stringnullable

    The type of the component. Could be 'Fabric', 'Component' etc.

    sku stringnullable

    The unique identifier of the component For fabrics, this is the fabric ID.

    amount double

    The quantity or amount of the component used.

    unit stringnullable

    The unit of measurement for the component amount.

    componentProduct

    object

    nullable

    The detailed component product information for this component.

    oneOf

    Acts as a base for all component products.

    Generic components use this directly

    category

    string

    required

    Possible values: [Fabric]

    The category of the product.

    type stringnullable

    The type of the fabric component product. Equal to 'Fabric'.

    fabricFormationType FabricFormationType (string)

    Possible values: [Knit, Woven, Non-Woven]

    The fabric formation type of a fabric.

    yarnSizeValue

    object

    value stringnullable
    unit stringnullable
    printedSurfaceArea doublenullabledeprecated

    The printed surface area of the fabric

    printedSurfaceAreaUnit stringnullabledeprecated

    The printed surface area unit. Can be 'm2' which is meter-square or '%' which implies percentage of the fabric amount that is printed.

    gsm doublenullable

    The GSM of the fabric

    id stringnullable

    The unique identifier of the product.

    productionTimestamp date-time

    The timestamp when the product was produced.

    created date-time

    The timestamp when the product was created in the system.

    updated date-timenullable

    The timestamp when the product was last updated.

    name stringnullable

    The name of the product.

    articleNumber stringnullable

    The article number of the product.

    sku stringnullable

    The Stock Keeping Unit (SKU) of the product.

    materials

    object[]

    nullable

    The list of raw materials used in the product.

  • Array [

  • name stringnullable

    The name of the raw material.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    materialPercentageInComponent doublenullable

    The percentage of this material by weight in a component. For materials not used in a component, this is set to the weight distribution across the remainder of the product by weight.

    recyclingInformation

    object

    Represents recycling information for a material.

    recyclingPercentage double

    The percentage of the material that is recycled.

    recyclingSource stringnullable

    The source of the recycled material.

    recyclingCollection RecycledMaterialCollectionMethod (string)

    Possible values: [Pre-Consumer, Post-Consumer]

    The method of collecting the recycled material ///

    recyclingProcess RecycledMaterialProcessingMethod (string)

    Possible values: [Mechanical, Chemical, Chemical (Glycolysis), Chemical (Methanolysis)]

    The method of processing the recycled material

    hops

    object[]

    nullable

    The list of transport hops for this raw material.

  • Array [

  • sourceId stringnullable

    The ID of the source entity.

    destinationId stringnullable

    The ID of the destination entity.

    legs

    object[]

    nullable

    The individual transport legs between the source and destination.

  • Array [

  • utilizationRatio doublenullable

    The utilization ratio which represents the % of the transport mode that is utilized for moving the item.

    distanceInKms doublenullable

    The distance covered as part of this leg.

    mode TransportMode (string)

    Possible values: [Truck, Train, Van, Car, Barge, Ship, Plane]

    Represents the mode of transport. ///

  • ]

  • ]

  • certifications string[]nullable

    The list of certifications associated with this raw material.

  • ]

  • accessories

    object[]

    nullable

    The list of accessories associated with the product.

  • Array [

  • type stringnullable

    The type of the accessory.

    amount doublenullable

    The quantity or amount of the accessory.

    unit stringnullable

    The unit of measurement for the accessory amount.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

  • ]

  • packaging

    object

    The packaging material details of this product.

    materials

    object[]

    nullable

    The packaging materials used to pack this product.

  • Array [

  • material stringnullable

    The material used for packaging.

    type PackagingType (string)

    Possible values: [Primary, Secondary, Tertiary, Intermediate]

    The type of packaging. Primary indicates the material the product is first wrapped with (like polybag) Secondary indicates the secondary layer on top of the primary layer (like cardboard) Tertiary indicates things like pallets which are used in warehouses.

    weightInGms doublenullable

    The weight of the packaging material in grams.

    supplierId stringnullable

    The unique identifier of the supplier for this packaging material.

    supplierLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    recyclingInformation

    object

    Represents recycling information for a material.

    recyclingPercentage double

    The percentage of the material that is recycled.

    recyclingSource stringnullable

    The source of the recycled material.

    recyclingCollection RecycledMaterialCollectionMethod (string)

    Possible values: [Pre-Consumer, Post-Consumer]

    The method of collecting the recycled material ///

    recyclingProcess RecycledMaterialProcessingMethod (string)

    Possible values: [Mechanical, Chemical, Chemical (Glycolysis), Chemical (Methanolysis)]

    The method of processing the recycled material

  • ]

  • weightInGms doublenullable

    The weight of the product in grams.

    intrinsicValue doublenullable

    The intrinsic value of the product.

    organizationId stringnullable

    The unique identifier of the organization associated with the product.

    subsidiaryId stringnullable

    The unique identifier of the subsidiary associated with the product.

    certifications string[]nullable

    The list of certifications associated with the product.

    passportEnabled booleannullable

    Indicates whether the product is passport enabled.

    status EntityStatus (string)

    Possible values: [Active, Snapshot, Draft, Submitted, Template]

    The status of the entity in the Carbon Trail platform.

    components undefined[]nullable

    The list of components that make up the product.

    hazardousSubstances string[]nullable

    The list of hazardous substances associated with the product.

    cutOffDate date-timenullable

    The cut-off date for the product data. After the cut-off date, no changes are allowed to the product.

    submitterUserEmail stringnullable

    The email of the user who submitted the product.

    customFieldValues

    object[]

    nullable

    The list of custom field values associated with the product.

  • Array [

  • oneOf

    Represents a custom field value.

    type

    string

    required

    Possible values: [Text, Select, Multi-Select]

    value stringnullable

    The value of the text custom field.

    customFieldId stringnullable

    The unique identifier of the custom field this value is associated with.

  • ]

  • manufacturingDetails

    object

    Represents the manufacturing details of a product.

    processes

    object[]

    nullable

    The list of manufacturing processes involved in creating the product.

  • Array [

  • name stringnullable

    The name of the manufacturing process.

    performed booleannullable

    Indicates whether the process has been performed.

    technology stringnullable

    The technology used in the manufacturing process.

    supplierId stringnullable

    The unique identifier of the supplier.

    facilityId stringnullable

    The unique identifier of the facility where the process takes place.

    location

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    lossPercentage doublenullable

    The loss percentage of this process.

    flowSequenceNumber int32

    The sequence number of this process in the overall manufacturing flow. Lower number implies the process is performed earlier. Starts from 1.

    applicableSurfaceArea

    object

    value double
    unit stringnullable
    percentageShare doublenullable

    The percentage share of this process in the overall manufacturing. Useful for multi-sourcing scenarios where a process is performed in multiple factories.

  • ]

  • lossPercentage doublenullable

    The overall loss percentage across the entire manufacturing. Don't use this if you are specifying loss % at a process-level.

    manufacturingLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    supplierId stringnullable

    The unique identifier of the supplier.

    facilityId stringnullable

    The unique identifier of the manufacturing facility.

    hops

    object[]

    nullable

    The list of transport hops involved in the manufacturing.

  • Array [

  • sourceId stringnullable

    The ID of the source entity.

    destinationId stringnullable

    The ID of the destination entity.

    legs

    object[]

    nullable

    The individual transport legs between the source and destination.

  • Array [

  • utilizationRatio doublenullable

    The utilization ratio which represents the % of the transport mode that is utilized for moving the item.

    distanceInKms doublenullable

    The distance covered as part of this leg.

    mode TransportMode (string)

    Possible values: [Truck, Train, Van, Car, Barge, Ship, Plane]

    Represents the mode of transport. ///

  • ]

  • ]

  • type stringnullable

    The type of the component product.

    amount doublenullable

    The amount of the component product.

    unit stringnullable

    The unit of measurement for the component product.

  • ]

  • hazardousSubstances string[]nullable

    The list of hazardous substances associated with the product.

    cutOffDate date-timenullable

    The cut-off date for the product data. After the cut-off date, no changes are allowed to the product.

    submitterUserEmail stringnullable

    The email of the user who submitted the product.

    customFieldValues

    object[]

    nullable

    The list of custom field values associated with the product.

  • Array [

  • oneOf

    Represents a custom field value.

    type

    string

    required

    Possible values: [Text, Select, Multi-Select]

    value stringnullable

    The value of the text custom field.

    customFieldId stringnullable

    The unique identifier of the custom field this value is associated with.

  • ]

  • manufacturingDetails

    object

    Represents the manufacturing details of a product.

    processes

    object[]

    nullable

    The list of manufacturing processes involved in creating the product.

  • Array [

  • name stringnullable

    The name of the manufacturing process.

    performed booleannullable

    Indicates whether the process has been performed.

    technology stringnullable

    The technology used in the manufacturing process.

    supplierId stringnullable

    The unique identifier of the supplier.

    facilityId stringnullable

    The unique identifier of the facility where the process takes place.

    location

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    lossPercentage doublenullable

    The loss percentage of this process.

    flowSequenceNumber int32

    The sequence number of this process in the overall manufacturing flow. Lower number implies the process is performed earlier. Starts from 1.

    applicableSurfaceArea

    object

    value double
    unit stringnullable
    percentageShare doublenullable

    The percentage share of this process in the overall manufacturing. Useful for multi-sourcing scenarios where a process is performed in multiple factories.

  • ]

  • lossPercentage doublenullable

    The overall loss percentage across the entire manufacturing. Don't use this if you are specifying loss % at a process-level.

    manufacturingLocation

    object

    Represents a geographical location.

    id stringnullable

    The unique identifier of the location.

    city stringnullable

    The name of the city.

    country stringnullable

    The country code.

    countryName stringnullable

    The full name of the country.

    continent stringnullable

    The name of the continent.

    supplierId stringnullable

    The unique identifier of the supplier.

    facilityId stringnullable

    The unique identifier of the manufacturing facility.

    hops

    object[]

    nullable

    The list of transport hops involved in the manufacturing.

  • Array [

  • sourceId stringnullable

    The ID of the source entity.

    destinationId stringnullable

    The ID of the destination entity.

    legs

    object[]

    nullable

    The individual transport legs between the source and destination.

  • Array [

  • utilizationRatio doublenullable

    The utilization ratio which represents the % of the transport mode that is utilized for moving the item.

    distanceInKms doublenullable

    The distance covered as part of this leg.

    mode TransportMode (string)

    Possible values: [Truck, Train, Van, Car, Barge, Ship, Plane]

    Represents the mode of transport. ///

  • ]

  • ]

Loading...