# List Promotion Definitions

This method allows the client to list all promotion definitions

Endpoint: GET /promotions/definitions
Version: 4.3.4
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)
    Example: null

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

  - `validTo` (string)
    Example: null

  - `redemptionLimit` (integer)
    Example: 1

  - `unlimitedRedemption` (boolean)
    Example: false

  - `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)
    Example: null

  - `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