Skip to content

Declared FEC — by unique identifier
deprecated

Request

Call by: uniqueIdentifier — your internal brand product reference (same value as on POST /brand-products).

Returns the declared French Environmental Cost (FEC) published for the matching brand product.

This is the customer-facing declared FEC (government platform publication), distinct from the calculated FEC returned by GET /calculated-french-environmental-cost/....

Requires a Customer API bearer token. Your registry customer scope is resolved from the token.

uniqueIdentifier is not validated as a UUID — any non-empty URL-encoded string is accepted.

Error responses use a dedicated JSON shape: machine-readable codes are returned in details[].reason.

Path
uniqueIdentifierstring, non-emptyrequired

Your brand product uniqueIdentifier (same value as on POST /brand-products). Any non-empty URL-encoded string is accepted; it is not validated as a UUID.

curl -i -X GET \
  'https://doc.api.fairlymade.com/_mock/swagger-fairlymadeapi-v3/declared-french-environmental-cost/by-unique-identifier/{uniqueIdentifier}'

Responses

Declared FEC available for this brand product.

Bodyapplication/json
scoringobject(DeclaredFrenchEnvironmentalCostScoring)

Declared FEC score breakdown.

publishedFrenchEnvironmentalCostnumber

Declared FEC score published on the government platform.

publishedFrenchEnvironmentalCostPerUnitWeightnumber

Declared FEC per unit weight (g).

pictogramstring, (uri)

URL of the published FEC pictogram.

isPublishedOnGovernmentPlatformboolean

Whether the FEC has been published on the government platform.

governmentPlatformPublicationDatestring or null, (date-time)

Publication date on the government platform, when available.

calculatedAtstring, (date-time)required

Timestamp of the declared FEC record.

Response
{
  "scoring": {
    "brandScore": 1.41,
    "productScore": 2653,
    "frenchEnvironmentalCost": 1882
  },
  "publishedFrenchEnvironmentalCost": 1882,
  "publishedFrenchEnvironmentalCostPerUnitWeight": 2.67,
  "pictogram": "https://affichage-environnemental.ecobalyse.beta.gouv.fr/api/image?type=score&score=1882&masse=0.705",
  "isPublishedOnGovernmentPlatform": true,
  "governmentPlatformPublicationDate": "2024-11-18T12:50:01.151Z",
  "calculatedAt": "2024-11-18T12:50:01.151Z"
}