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

# Get labels for French Eco-Scores

Returns official Ecobalyse SVG labels for one or more products in your library. Use this endpoint to retrieve the visual French Eco-Score (Environmental Cost) for display on product pages or packaging.

<Note title="productIds">
  Specify an array of up to 50 product IDs to retrieve labels in a single request.
</Note>

### Request body properties

| Name         | Type            | Description                                                                            |
| :----------- | :-------------- | :------------------------------------------------------------------------------------- |
| `productIds` | `Array<string>` | **\[REQUIRED]** The list of Worldly product IDs for which you want to generate labels. |

### Implementation details

* **Batch limit**: You can request labels for a maximum of 50 products per request.
* **Error isolation**: The endpoint uses per-product error isolation. If one product fails to generate a label (e.g., due to missing mandatory French Eco-Score data), the response still contains labels for the successful products.
* **SVG output**: The `svg` property in the response contains the raw SVG string. You can render this string directly in a browser or save it as a file.

### Response body properties

| Name        | Type     | Description                                                                      |
| :---------- | :------- | :------------------------------------------------------------------------------- |
| `productId` | `string` | **\[REQUIRED]** The ID of the product.                                           |
| `code`      | `number` | The calculated French Eco-Score value. `null` when label generation fails.       |
| `error`     | `string` | A description of the error if the label could not be generated for this product. |
| `svg`       | `string` | The raw SVG data for the label. `null` when label generation fails.              |

### Related recipes

<Card title="PIC - Retrieve French Eco-Score" href="/recipes/retrieve-french-eco-score" />

<Card title="PIC - Update Product with French Eco-Score requirements" href="/recipes/french-eco-score-update" />

<Card title="PIC - Create Product with French Eco-Score Optional Fields" href="/recipes/french-eco-score-optional-fields" />

Check the [PIC Data Dictionary](/data-dictionary/pic) for more information on French Eco-Score fields.


## OpenAPI

````yaml api-reference/openapi/french-eco.json POST /french-label/image
openapi: 3.0.0
info:
  title: pic-api
  version: 1.0.0
servers:
  - url: https://api-v2.production.higg.org/pic-api/v1
    description: Production
  - url: https://api-v2.demo.higg.org/pic-api/v1
    description: Demo
security:
  - sec0: []
    sec1: []
paths:
  /french-label/image:
    post:
      summary: Get French Eco Score SVG Labels
      operationId: GetSvgLabels
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FrenchLabelImageRequest'
        required: true
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/FrenchLabelSvgResult'
                type: array
components:
  schemas:
    FrenchLabelImageRequest:
      properties:
        productIds:
          items:
            type: string
          type: array
      required:
        - productIds
      type: object
      additionalProperties: false
    FrenchLabelSvgResult:
      properties:
        productId:
          type: string
        svg:
          type: string
          nullable: true
        error:
          type: string
          nullable: true
        code:
          type: number
          format: double
          nullable: true
      required:
        - productId
      type: object
      additionalProperties: false
  securitySchemes:
    sec0:
      type: apiKey
      in: header
      name: x-api-key
    sec1:
      type: apiKey
      in: header
      name: x-developer-request-token

````