# Generate DPE/GES label

Generates the DPE/GES energy label visual for a product.
The DPE/GES letters and values come from the product's criteria; only the
rendering options below can be provided. All fields are optional and fall
back to the defaults values.
Returns either a file, a URL or an encoded payload depending on the
`response` option.

Endpoint: POST /products/{productId}/dpeGes
Version: 1.6.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer opaque

## Path parameters:

  - `productId` (integer, required)

## Request fields (application/json):

  - `position` (string)
    Layout of the DPE and GES visuals (horizontal or vertical). Default `H`.
    Enum: "H", "V"

  - `width` (integer)
    Output width in pixels (raster formats).

  - `height` (integer)
    Output height in pixels (raster formats).

  - `format` (string)
    Output image format. Default `svg`.
    Enum: "svg", "jpeg", "png"

  - `response` (string)
    Response type — raw file, URL, or base64-encoded content. Default `file`.
    Enum: "file", "url", "encode"

## Response 200:

  - `200` (unknown)
    DPE/GES label (file, URL or encoded payload)

## Response 403:

  - `403` (unknown)
    Access denied. The error `code` is always `FORBIDDEN`; the `message` gives the cause:
- `You do not have permission to perform this action.`
 — the access does not

hold the API pack / right required by the endpoint.
- `Insufficient scope for this request.`
 — the resource targeted by the request

(user, customer, product, agency, transaction, ...) is outside the scope of

the authenticated access.
- `Access denied for this editor.`
 /
`Your IP address has been blocked.`
 —

editor or IP restriction.

## Response 403 fields (application/json):

  - `error` (object)

  - `error.code` (string, required)

  - `error.message` (string, required)

## Response 422:

  - `422` (unknown)
    Validation failed

## Response 422 fields (application/json):

  - `error` (object)

  - `error.code` (string)
    Enum: "VALIDATION_ERROR"

  - `error.message` (string)

  - `error.details` (array)

  - `error.details.field` (string)

  - `error.details.message` (string)

## Response 403 examples:

  - `Missing API pack / right` (unknown)

  - `Resource outside the scope of the access` (unknown)

