Skip to content
Saleor
Esc
↑↓navigate↵open⌘Jpreview

Schema: Saleor 3.23.43Download SDLUpgrade guides

On this page

promotion Query

Look up a promotion by ID or external reference.

Requires one of the following permissions:MANAGE_DISCOUNTS
promotion(id: ID, externalReference: String): Promotion

Returns

Promotion

Show return type
type Promotion implements Node & ObjectWithMetadata {
  id: ID!
  privateMetadata: [MetadataItem!]!
  privateMetafield(key: String!): String
  privateMetafields(keys: [String!]): Metadata
  metadata: [MetadataItem!]!
  metafield(key: String!): String
  metafields(keys: [String!]): Metadata
  name: String!
  externalReference: String
  type: PromotionTypeEnum
  description: JSON
  startDate: DateTime!
  endDate: DateTime
  createdAt: DateTime!
  updatedAt: DateTime!
  rules: [PromotionRule!]
  translation(languageCode: LanguageCodeEnum!): PromotionTranslation
  events: [PromotionEvent!]
}

Arguments

id

id · ID

ID of the promotion.

externalReference

externalReference · String

External ID of the promotion.

Added in Saleor 3.23

Schema: Saleor 3.23.43. Download SDL.

Last updated on April 13, 2026

Was this page helpful?