# List Promotion Definitions

This method allows the client to list all promotion definitions

Endpoint: GET /promotions/definitions
Version: 4.3.3
Security: api_key

## Response 200 fields (application/json):

  - `id` (string)
    Example: "8F96A471-05F4-4A9B-8156-97BD35F6F29D"

  - `active` (boolean)
    Example: true

  - `name` (string)
    Example: "Voucher kr 100,-"

  - `description` (string)
    Example: "This is your welcome offer. Use it to get a discount on your next purchase."

  - `linkUrl` (string)
    Example: "https://cdn.oculos.no/8F96A471-05F4-4A9B-8156-97BD35F6F29D"

  - `imageUrl` (string)
    Example: "https://cdn.oculos.no/8F96A471-05F4-4A9B-8156-97BD35F6F29D.png"

  - `type` (string)
    Example: "Promotion"

  - `subType` (string)

  - `validFrom` (string)
    Example: "2025-03-01T00:00:00"

  - `validTo` (string)

  - `redemptionLimit` (integer)
    Example: 1

  - `unlimitedRedemption` (boolean)

  - `redemptionChannels` (array)

  - `redemptionChannels.type` (string)
    Example: "eCom"

  - `redemptionChannels.valueType` (string)
    Example: "amount"

  - `redemptionChannels.value` (string)
    Example: "100"

  - `redemptionChannels.message` (string)

  - `productsIncluded` (array)
    Example: []

  - `productsExcluded` (array)
    Example: []

  - `storesIncluded` (array)
    Example: []

  - `tiersIncluded` (array)
    Example: []

  - `clientId` (string)

  - `created` (string)
    Example: "2025-03-06T13:11:25.233"

  - `createdBy` (string)
    Example: "no-reply@oculos.no"

  - `updated` (string)
    Example: "2025-03-06T13:11:25.233"

  - `updatedBy` (string)
    Example: "no-reply@oculos.no"


## Response 400 fields

## Response 401 fields

## Response 403 fields

## Response 404 fields