This tutorial will guide you through the process of installing and configuring a REST client in order to call the REST API on Semarchy xDM.

Learning outcomes

Learning track

This tutorial is the fourth unit within the Data Publishing & Consumption track, which is composed of SQL-based and REST-based tutorials.

The current unit is a prerequisite for the REST-based units of the Data Publishing & Consumption track:

Before following this tutorial, you must have set up Semarchy xDM and completed the Customer B2C demo tutorial.

If you have not yet, complete the Quick Install and Demo Applications tracks.


Otherwise, enjoy this tutorial!

While it is possible to make calls to the REST API via your web browser or using a command line tool like cURL, we recommend using a tool specialized for API development environments. This will be particularly useful for the two tutorial units dedicated to the REST API, namely Query data via the REST API and Load data via the REST API.

Therefore, we recommend Postman, which is available for free and easy to use. If you prefer to use another tool that your organization supports, you are welcome to do so.

Get the Postman app

  1. To begin, download the Postman app for your platform from the Postman website.


  1. Install the application.

Initialize a request

Follow the instructions below to initialize your first request in Postman.

  1. In the My Workspace side navigation menu, click on the New button.
  2. Select Collection.
  3. Enter a name for the collection (i.e., the virtual folder) where you want to store your request.
  4. Your newly created collection appears in the side navigation menu, with a message reading "This collection is empty. Add a request to start working."
    Click the "Add a request" link to create a new request in this collection.
  5. Enter a name for your new request.

Set up authentication

Accessing the REST API is a task normally performed by an integration developer. As a result, we are going to use the semadmin user who has full administrative privileges to do everything in the xDM platform, including using the REST API.

To set up authorization:

  1. Click on the Authorization tab.
  2. In the Type section, click the drop-down menu.
  3. Select Basic Auth.

  1. Enter the username and password for your Semarchy admin user. Use the same credentials that you use to connect to xDM as the semadmin user:

To test your Postman configuration, you will now retrieve all the customer golden records in the Person entity from the CustomerB2CDemo data location. The template request you need is:


  1. Modify the request to use your host and port:



You can use either the public DNS address or the public IP address. We will proceed with the IP address in future examples in this tutorial.

  1. Test your credentials:

3. Click Send.

4. If you have correctly set up the authorization with your credentials, then you should see results returned. These are all the customer golden records returned in JSON format.

Great job! You successfully configured a REST client and sent your first request via the REST API.

Next steps

In the next unit of the Data Publishing & Consumption track, you will learn how to query data in xDM via the REST API. You will perform basic queries and learn about setting up and using named queries.

To explore other resources, return to the Tutorials menu.


Thank you for completing this tutorial.