# Get study details

Endpoint: GET /v2/studies
Version: 2.0
Security: bearer

## Query parameters:

  - `lang` (array)
    Languages for AGEC Claims translations
    Enum: "fr", "en", "es", "it"

  - `collectionRef` (string, required)
    The brand collection reference

  - `productRef` (string, required)
    The product reference

  - `colorCode` (string, required)
    The product's color code

## Response 200 fields (application/json):

  - `id` (string, required)
    Unique identifier of this study

  - `state` (string, required)
    Last known state of study's progress
    Enum: "PLANNED", "REVIEWED", "ARCHIVED", "PUBLISHED", "COMPLETED", "IN_PROGRESS", "CANCELLED"

  - `brandCollectionName` (string, required)
    Name of the brand collection the study belongs to

  - `category` (string, required)
    Category of the study

  - `productRef` (string, required)
    Product reference

  - `colorCode` (string, required)
    Color code of the study

  - `projectType` (string, required)
    The type of project the study belongs to

  - `purchaseOrder` (string, required)
    Purchase order the study is linked to

  - `showcaseLinks` (string, required)
    A list of links to showcases separated by semi-colons

  - `weight` (number, required)
    Weight in grams of the product

  - `ecoModulation` (string, required)
    Eco contribution information

  - `picture` (string, required)
    A link to the study's picture

  - `product` (object, required)
    Product data the study is referring to

  - `product.id` (string, required)
    Unique identifier of this product

  - `product.ref` (string, required)
    Reference code of the product

  - `product.name` (string, required)
    Name of the product

  - `product.publicName` (string, required)
    Public name of the product usually displayed on public ressources

  - `product.certifications` (array, required)
    List of certifications tied to this product

  - `product.certifications.name` (string, required)

  - `product.certifications.status` (string, required)
    Enum: "NOT_VERIFIED", "CAUTION", "VALIDATED", "EXPIRED"

  - `product.certifications.isVisible` (boolean, required)

  - `components` (array, required)
    A list of components linked to this study

  - `components.ref` (string, required)
    Ref of the component

  - `components.supplierCode` (string, required)
    Supplier reference code linked to the component

  - `components.lotReferences` (array, required)
    A list of batch reference

  - `components.type` (string, required)
    Type of component

  - `components.generalComposition` (string, required)
    General composition of the component separated by semi-colons

  - `components.name` (string, required)
    Name of the component

  - `components.category` (string, required)
    Category of the component

  - `components.composition` (array, required)
    A list of material used to make the component

  - `components.composition.id` (string, required)
    Unique identifier of the material

  - `components.composition.percentage` (number, required)
    Percentage of this material the parent component is made of

  - `components.composition.raw_material` (string, required)
    Name of its raw material

  - `components.composition.raw_material_smcp` (string, required)
    Specific raw material name for SMCP

  - `components.composition.materialTranslations` (object, required)
    Name of its raw material in different languages

  - `components.composition.materialTranslations.en` (string)

  - `components.composition.materialTranslations.fr` (string)

  - `components.composition.materialTranslations.es` (string)

  - `components.composition.materialTranslations.it` (string)

  - `components.composition.traceability_steps` (array, required)
    A list of traceability steps making a full branch from this material to the upmost parent (should be product)

  - `components.composition.traceability_steps.id` (string, required)
    Unique identifier of this traceability step

  - `components.composition.traceability_steps.name` (string, required)
    Name of the traceability step

  - `components.composition.traceability_steps.position` (string, required)
    Three sets of numbers going from 001 to 999, giving the absolute position of the traceability step in the tree

  - `components.composition.traceability_steps.icon` (string, required)
    Icon attached to the traceability step

  - `components.composition.traceability_steps.transports` (array, required)
    List of all means of transportation travelling from this traceability step

  - `components.composition.traceability_steps.transports.type` (string, required)
    Type of this transport

  - `components.composition.traceability_steps.transports.distance` (number, required)
    Distance travelled with this transport

  - `components.composition.traceability_steps.transportationType` (string)
    Default transportation type assigned

  - `components.composition.traceability_steps.supplier` (object, required)
    Information about the supplier linked to the traceability step

  - `components.composition.traceability_steps.supplier.ref` (string)
    Reference of this supplier

  - `components.composition.traceability_steps.supplier.city` (string, required)
    City of this supplier

  - `components.composition.traceability_steps.supplier.country` (string, required)
    Country of this supplier

  - `components.composition.traceability_steps.supplier.region` (string, required)
    Region of this supplier

  - `components.composition.traceability_steps.supplier.socialCertifications` (array, required)
    List of social certifications this supplier has

  - `components.composition.traceability_steps.supplier.socialCertifications.ref` (string, required)
    Reference code of this certification

  - `components.composition.traceability_steps.supplier.socialCertifications.name` (string, required)
    Name of the certification

  - `components.composition.traceability_steps.supplier.socialCertifications.status` (string, required)
    Current status for this certification
    Enum: "NOT_VERIFIED", "CAUTION", "VALIDATED", "EXPIRED"

  - `components.composition.traceability_steps.supplier.socialCertifications.isVisible` (boolean, required)
    Indicates if the document can be displayed or not

  - `components.composition.traceability_steps.supplier.environmentalCertifications` (array, required)
    List of environmental certifications this supplier has

  - `components.composition.traceability_steps.supplier.isKnown` (boolean, required)
    Indicates if the supplier is known by the system

  - `components.composition.traceability_steps.supplier.name` (string)
    The name of this supplier

  - `components.composition.traceability_steps.supplier.id` (string)
    The unique identifier of this supplier

  - `components.composition.traceability_steps.kmToNext` (number, required)
    Number of kilometers separating this traceability step and the next one

  - `components.weight` (number, required)
    Weight of the component

  - `components.categoryTranslations` (object, required)
    Category of component in different languages
    Example: {"en":"Paddings","fr":"Rembourrage","es":"Acolchado"}

  - `results` (object, required)
    Collection of results and the various impacts the whole product has

  - `results.resourceUseMineralsMetals` (number, required)
    EF impact category that addresses the use of non-renewable abiotic natural resources (minerals and metals) (in kg Sb eq)

  - `results.resourceUseFossils` (number, required)
    EF impact category that addresses the use of non-renewable fossil natural resources (e.g. natural gas, coal, oil) (in MJ)

  - `results.acidification` (number, required)
    Impacts due to acidifying substances in the environment. The protons contribute to the acidification of soils and water when they are released in areas where the buffering capacity is low, resulting in forest decline and lake acidification (in mol H+ eq)

  - `results.humanToxicityCancer` (number, required)
    EF impact category that accounts for adverse health effects on human beings caused by the intake of toxic substances through inhalation of air, food/water ingestion, penetration through the skin insofar as they are related to cancer (in CTUh)

  - `results.humanToxicityNonCancer` (number, required)
    EF impact category that accounts for the adverse health effects on human beings caused by the intake of toxic substances through inhalation of air, food/water ingestion, penetration through the skin insofar as they are related to non-cancer effects (in CTUh)

  - `results.eutrophicationFreshWater` (number, required)
    Nutrients from sewage outfalls and fertilised farmland accelerate the growth of algae and other vegetation in water. The degradation of organic material consumes oxygen resulting in oxygen deficiency and, in some cases, fish death (in kg P eq)

  - `results.eutrophicationMarine` (number, required)
    Nutrients from sewage outfalls and fertilised farmland accelerate the growth of algae and other vegetation in water. The degradation of organic material consumes oxygen resulting in oxygen deficiency and, in some cases, fish death (in kg N eq)

  - `results.eutrophicationTerrestrial` (number, required)
    Nutrients from sewage outfalls and fertilised farmland accelerate the growth of algae and other vegetation in water. The degradation of organic material consumes oxygen resulting in oxygen deficiency and, in some cases, fish death (in mol N eq)

  - `results.climateChange` (number, required)
    All inputs or outputs that result in greenhouse gas emissions. The consequences include increased average global temperatures and sudden regional climatic changes. Climate change is an impact affecting the environment on a global scale (in kg CO2 eq)

  - `results.climateChangeBiogenic` (number, required)

  - `results.climateChangeFossil` (number, required)

  - `results.climateChangeLandUse` (number, required)

  - `results.ionisingRadiation` (number, required)
    EF impact category that accounts for the adverse health effects on human health caused by radioactive releases (in kBq U235 eq)

  - `results.landuse` (number, required)
    Use (occupation) and conversion (transformation) of land area by activities such as agriculture, forestry, roads, housing, mining, etc. (in points)

  - `results.ozoneDepletion` (number, required)
    Degradation of stratospheric ozone due to emissions of ozone-depleting substances, for example long-lived chlorine and bromine containing gases (e.g. CFCs, HCFCs, Halons) (in kg CFC^-11 eq)

  - `results.particulateMatter` (number, required)
    EF impact category that accounts for the adverse health effects on human health caused by emissions of Particulate Matter (PM) and its precursors (NOx, SOx, NH3) (Diseace Incidence)

  - `results.photochemicalOzoneFormation` (number, required)
    Formation of ozone at the ground level of the troposphere caused by photochemical oxidation of volatile organic compounds (VOCs). High concentrations of ground-level tropospheric ozone damage vegetation, human respiratory tracts and manmade materials through reaction with organic materials (in kg NMVOC eq)

  - `results.waterUse` (number, required)
    Relative available water remaining per area in a watershed, after the demand of humans and aquatic ecosystems has been met. It assesses the potential of water deprivation, to either humans or ecosystems, building on the assumption that the less water remaining available per area (in m^3 eq)

  - `results.recycledMaterialsPercentage` (number, required)

  - `results.microplasticPercentage` (number, required)

  - `results.climateChangeEquivalence` (object, required)

  - `results.eutrophicationFreshWaterEquivalence` (object, required)

  - `results.resourceUseFossilsEquivalence` (object, required)

  - `results.grades` (object, required)
    A collection of grades rating the impacts of the product they're referring to

  - `results.grades.recyclability` (number, required)
    Ability to effectively recycle waste from identical or similar products

  - `results.grades.traceability` (number, required)
    The Traceability Score of a product represents the degree of knowledge of its value chain. We estimate the number of manufacturing steps required to produce the item and its main components and we evaluate the number of known suppliers within this theoretical value chain

  - `results.grades.compliance` (number, required)
    Average of the social performance of the various stakeholders in the value chain associated with it

  - `results.frenchSingleScore` (number, required)

  - `results.frenchSingleScorePerUnitWeight` (number, required)
    French Single Score per unit weight

  - `results.frenchSingleScoreDetails` (object, required)

  - `results.frenchSingleScoreDetails.brandScore` (number, required)
    Score of the brand

  - `results.frenchSingleScoreDetails.productScore` (number, required)
    Score of the product

  - `results.frenchSingleScoreDetails.malusBonusServiceDuration` (number, required)

  - `results.frenchSingleScoreDetails.referenceServiceDuration` (number, required)

  - `results.frenchSingleScoreDetails.adjustedServiceDuration` (number, required)

  - `results.frenchSingleScoreDetails.lcaFrenchSingleScore` (number, required)

  - `results.frenchSingleScoreDetails.ooeuExportFrenchSingleScore` (number, required)

  - `results.frenchSingleScoreDetails.microfibersFrenchSingleScore` (number, required)

  - `results.frenchSingleScoreDetails.productRangeCoefficient` (number, required)

  - `results.frenchSingleScoreDetails.repairPromotionCoefficient` (number, required)

  - `results.frenchSingleScoreDetails.traceabilityDisplayCoefficient` (number, required)

  - `results.frenchSingleScoreDetails.brandSettings` (object, required)
    Brand details

  - `results.frenchSingleScoreDetails.brandSettings.companySize` (object, required)

  - `results.frenchSingleScoreDetails.brandSettings.repairService` (boolean, required)

  - `results.frenchSingleScoreDetails.brandSettings.traceabilityDisplay` (boolean, required)

  - `results.frenchSingleScoreDetails.brandSettings.maxReferencesNumber` (number, required)

  - `results.frenchSingleScoreDetails.brandSettings.productPrice` (number, required)

  - `results.frenchSingleScoreDetails.brandSettings.createdAt` (string, required)

  - `results.ecotoxicityFreshWater` (number, required)

  - `links` (array, required)
    A list of minimal information on links related to this study

  - `links.link` (string, required)
    URL pointing to an HTTP ressource

  - `links.type` (string, required)
    Type of the link

  - `showcaseTexts` (object, required)
    Dynamic texts displayed on the study's showcase

  - `showcaseTexts.materialTextDescription` (object, required)
    Description for material

  - `showcaseTexts.recyclabilityTextDescription` (object, required)
    Description for recyclability

  - `showcaseTexts.descriptionACV` (object, required)
    Description for the Lifecycle Analysis

  - `showcaseTexts.descriptionACVSpecific` (object, required)
    Specific description for the Lifecycle Analysis

  - `packaging` (array, required)
    A list of packagings linked to this study

  - `packaging.id` (string, required)
    Unique identifier of this packaging

  - `packaging.packagingRef` (string, required)
    Ref of the Packaging

  - `packaging.type` (string, required)
    Type of packaging

  - `packaging.channel` (string, required)
    Distribution channel where the packaging is used

  - `packaging.compostability` (string, required)
    Compostability of the packaging

  - `packaging.ecoModulation` (string, required)

  - `packaging.hazardousSubstances` (object, required)
    Hazardous substances that are part of the packaging

  - `packaging.percentageRecycled` (number, required)
    Percentage of the packaging that is made from recycled matter

  - `packaging.possibilityReUse` (string, required)
    Possibility of re-use of the packaging
    Enum: "N/A", "NO - 0", "YES - REFILLABLE", "YES - REUSABLE"

  - `packaging.recyclability` (string, required)
    Recyclability of the packaging: Taxonomy to be respected
    Enum: "N/A", "NO - 0", "YES - FULLY RECYCLING", "YES - FULLY RECYCLING + RECYCLABLE IN THE SAME TYPE OF PACKAGING", "YES - MOSTLY RECYCLING"

  - `packaging.typeTranslations` (object, required)
    Type of packaging in different languages
    Example: {"en":"Box","fr":"Boîte","es":"Caja"}

  - `packaging.agecClaims` (object, required)
    AGEC Claims at Packaging Level

  - `packaging.agecClaims.ecoModulation` (object, required)
    AGEC Claim : Eco modulation of the packaging

  - `packaging.agecClaims.compostability` (object, required)
    AGEC Claim : Compostability of the packaging

  - `packaging.agecClaims.recycledMaterials` (object, required)
    AGEC Claim : Recycled matter presence in the packaging

  - `packaging.agecClaims.recyclability` (object, required)
    AGEC Claim : Recyclability of the packaging

  - `packaging.agecClaims.possibilityReUse` (object, required)
    AGEC Claim : Possibility of re-use of the packaging

  - `agecClaims` (object, required)
    AGEC Claims at Product Level

  - `agecClaims.ecoModulation` (object, required)
    AGEC Claim : Eco Modulation of the product

  - `agecClaims.microfibers` (object, required)
    AGEC Claim : Microfibers presence in the product

  - `agecClaims.recycledMaterials` (object, required)
    AGEC Claim : Recycled matter presence in the product


## Response 404 fields