# Retrieve a promotion integration

Endpoint: GET /integrations/promotion
Version: 1.0.457.36910
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2 scopes: FullAccess, PromotionAdmin

## Response 200 fields (application/json):

  - `HashKey` (string)
    Security feature that allows your middleware to verify the digital signature in the request header to ensure you only accept trusted data.

  - `Url` (string)

  - `CustomAuthHeaderName` (string)
    The header name that can be passed to your middleware.

  - `CustomAuthHeaderValue` (string)
    The header value that can be passed to your middleware.

## Response 4XX:

  - `4XX` (unknown)
    Expected errors range from 400-409. Anything in the 5XX range indicates a server issue and should be reported to support.

## Response 4XX fields (application/json):

  - `StatusCode` (integer)
    Example: 404

  - `ErrorCode` (string)
    Example: NotFoundError

  - `Message` (string)
    Example: Object not found

  - `Data` (object)
    Example: {"ObjectType":"","ObjectID":""}