Decision Management API developer guide

Last update: April 7, 2025

CREATED FOR:

  • Experienced
  • Developer

This developer guide provides steps to help you start using the Offer Library API. The guide then provides sample API calls for performing key operations using the decisioning engine.

➡️ Learn more about the components of Decision Management in this video

Prerequisites

This guide requires a working understanding of the following components of Adobe Experience Platform:

  • Experience Data Model (XDM) System: The standardized framework by which Experience Platform organizes customer experience data.
  • Decision Management: Explains the concepts and components used for Decisioning in general and decision management in particular. Illustrates the strategies used for choosing the best option to present during a customer’s experience.
  • Profile Query Language (PQL): PQL is a powerful language to write expressions over XDM instances. PQL is used to define decision rules.

Reading sample API calls

This guide provides example API calls to demonstrate how to format your requests. These include paths, required headers, and properly formatted request payloads. Sample JSON returned in API responses is also provided. For information on the conventions used in documentation for sample API calls, see the section on how to read example API calls in the Experience Platform troubleshooting guide.

Gather values for required headers

In order to make calls to Adobe Experience Platform APIs, you must first complete the authentication tutorial. Completing the authentication tutorial provides the values for each of the required headers in all Experience Platform API calls, as shown below:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}
  • x-sandbox-name: {SANDBOX_NAME}

All requests that contain a payload (POST, PUT, PATCH) require an additional header:

  • Content-Type: application/json

Next steps

This document covered the prerequisite knowledge required to make calls to the Offer Library API. You can now proceed to the sample calls provided in this developer guide and follow along with their instructions.

Previous pageFallback dataset
Next pageList placements

Journey Optimizer