DQE One API — Data Configuration

Data Configuration - DQE One API

The DQE One API is the backend API exposed by the DQE One package for Salesforce. The Data Configuration endpoints on this page retrieve the metadata and field definitions that drive data matching and mapping within a Salesforce organization, and let the organization register (“fusion”) lookup configurations for a given data-matching rule set. All three endpoints on this page are POST-only and authenticate with the DQE-Authorization header.

Related documentation:

DQE One API — Introduction (authentication model overview, health check)
DQE One API — Authentication & Session (how a DQE-Authorization key is obtained)

Jump to getDCMetadata getFusionField createFusionLookup

DC Metadata - DQE One API

Retrieves the data-configuration metadata used to drive data matching and mapping for a Salesforce organization.

getDCMetadata

Jump to Parameters Response Example Errors ▶ Test the API

Request

Send a JSON body to this endpoint with the DQE-Authorization header set.

{DOMAIN} is the domain of the server where your organization's own instance of the DQE One backend is installed — since this backend runs in your own infrastructure, this value is determined by your deployment, not issued by DQE. {DQE_AUTHORIZATION_KEY} is provided by DQE upon account/package setup; contact your DQE account manager to obtain it.

POSThttps://{DOMAIN}/getDCMetadata

Code examples

Retrieve data-configuration metadata

cURL JavaScript Python PHP Node.js Java C# Go

curl -X POST "https://{DOMAIN}/getDCMetadata" \
  -H "DQE-Authorization: {DQE_AUTHORIZATION_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "orgId": "00D5e0000008abcEAA",
  "crt": "2026-10-28T10:15:00Z",
  "sub": "0055e00000AbCnoFAF",
  "aud": "dqe-unify-api",
  "urllogin": "https://login.salesforce.com",
  "isForMapping": true,
  "orgPrefix": "dqe1"
}'

fetch("https://{DOMAIN}/getDCMetadata", {
  method: "POST",
  headers: {
    "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    orgId: "00D5e0000008abcEAA",
    crt: "2026-10-28T10:15:00Z",
    sub: "0055e00000AbCnoFAF",
    aud: "dqe-unify-api",
    urllogin: "https://login.salesforce.com",
    isForMapping: true,
    orgPrefix: "dqe1"
  })
})
  .then(r => r.json())
  .then(data => console.log(data));

import requests

response = requests.post(
    "https://{DOMAIN}/getDCMetadata",
    headers={
        "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    },
    json={
        "orgId": "00D5e0000008abcEAA",
        "crt": "2026-10-28T10:15:00Z",
        "sub": "0055e00000AbCnoFAF",
        "aud": "dqe-unify-api",
        "urllogin": "https://login.salesforce.com",
        "isForMapping": True,
        "orgPrefix": "dqe1",
    },
)
print(response.json())

<?php
$data = [
    'orgId' => '00D5e0000008abcEAA',
    'crt' => '2026-10-28T10:15:00Z',
    'sub' => '0055e00000AbCnoFAF',
    'aud' => 'dqe-unify-api',
    'urllogin' => 'https://login.salesforce.com',
    'isForMapping' => true,
    'orgPrefix' => 'dqe1',
];

$ch = curl_init("https://{DOMAIN}/getDCMetadata");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'DQE-Authorization: {DQE_AUTHORIZATION_KEY}',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

const axios = require('axios');

axios.post('https://{DOMAIN}/getDCMetadata', {
  orgId: '00D5e0000008abcEAA',
  crt: '2026-10-28T10:15:00Z',
  sub: '0055e00000AbCnoFAF',
  aud: 'dqe-unify-api',
  urllogin: 'https://login.salesforce.com',
  isForMapping: true,
  orgPrefix: 'dqe1'
}, {
  headers: {
    'DQE-Authorization': '{DQE_AUTHORIZATION_KEY}',
    'Content-Type': 'application/json'
  }
})
  .then(response => console.log(response.data));

HttpClient client = HttpClient.newHttpClient();

String body = "{\"orgId\":\"00D5e0000008abcEAA\",\"crt\":\"2026-10-28T10:15:00Z\",\"sub\":\"0055e00000AbCnoFAF\",\"aud\":\"dqe-unify-api\",\"urllogin\":\"https://login.salesforce.com\",\"isForMapping\":true,\"orgPrefix\":\"dqe1\"}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://{DOMAIN}/getDCMetadata"))
    .header("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"crt\":\"2026-10-28T10:15:00Z\",\"sub\":\"0055e00000AbCnoFAF\",\"aud\":\"dqe-unify-api\",\"urllogin\":\"https://login.salesforce.com\",\"isForMapping\":true,\"orgPrefix\":\"dqe1\"}";
var content = new StringContent(json, Encoding.UTF8, "application/json");

using var request = new HttpRequestMessage(HttpMethod.Post, "https://{DOMAIN}/getDCMetadata");
request.Headers.Add("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}");
request.Content = content;

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body := []byte(`{"orgId":"00D5e0000008abcEAA","crt":"2026-10-28T10:15:00Z","sub":"0055e00000AbCnoFAF","aud":"dqe-unify-api","urllogin":"https://login.salesforce.com","isForMapping":true,"orgPrefix":"dqe1"}`)

    req, _ := http.NewRequest("POST", "https://{DOMAIN}/getDCMetadata", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

Parameters

All fields are sent as a single JSON request body.

Note on Mandatory/Optional: the source OpenAPI specification does not declare a required array for this request body (only the body as a whole is marked required). All fields below are shown as Mandatory based on this project's documentation convention — confirm actual optionality with DQE engineering before publishing.

Field	Description	Type	Mand / Opt
orgId	The Salesforce organization ID making the request.	String	Mandatory
crt	The created/issued-at timestamp claim for this signed request.	String	Mandatory
sub	The subject claim — the Salesforce user or session identifier issuing the request.	String	Mandatory
aud	The audience claim — the intended recipient/target service for this signed request.	String	Mandatory
urllogin	The Salesforce org's login URL.	String	Mandatory
isForMapping	Whether this metadata request is being made for data-mapping purposes, as opposed to the organization's general data-configuration setup. Inferred from the field name only — not confirmed by the source specification.	Boolean	Mandatory
orgPrefix	The Salesforce package namespace prefix associated with the organization's DQE One installation. Inferred from the field name only — not confirmed by the source specification.	String	Mandatory

Response

Returns a JSON object containing the data-configuration metadata.

Key	Description	Type
dll	An array of string identifiers returned by the metadata lookup. The source specification does not define what this abbreviation stands for or how the entries should be interpreted — described here only as an array of string identifiers.	Array
dlm	An array of string identifiers returned by the metadata lookup. The source specification does not define what this abbreviation stands for or how the entries should be interpreted — described here only as an array of string identifiers.	Array

Response example

Example metadata response

{
  "dll": ["DC-0001", "DC-0002"],
  "dlm": ["DC-1001"]
}

The source specification gives no example values for this schema. The values above are illustrative placeholders only — no specific format is documented for dll/dlm entries.

Errors

The source specification does not define any error responses (4xx/5xx) for this endpoint — only the 200 success response is documented. Confirm actual error behavior with DQE engineering before publishing.

Test the API

Click the button below to test this endpoint live in your browser.

Open console

Fusion Field - DQE One API

Retrieves the field definitions available for a given data-matching rule set.

getFusionField

Jump to Parameters Response Example Errors ▶ Test the API

Request

Send a JSON body to this endpoint with the DQE-Authorization header set.

POSThttps://{DOMAIN}/getFusionField

Code examples

Retrieve fusion field definitions for a rule set

cURL JavaScript Python PHP Node.js Java C# Go

curl -X POST "https://{DOMAIN}/getFusionField" \
  -H "DQE-Authorization: {DQE_AUTHORIZATION_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "orgId": "00D5e0000008abcEAA",
  "ruleSetId": "RS-00456",
  "orgPrefix": "dqe1",
  "calculateParent": false,
  "crt": "2026-10-28T10:15:00Z",
  "selectedRules": ["name_match", "address_match"]
}'

fetch("https://{DOMAIN}/getFusionField", {
  method: "POST",
  headers: {
    "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    orgId: "00D5e0000008abcEAA",
    ruleSetId: "RS-00456",
    orgPrefix: "dqe1",
    calculateParent: false,
    crt: "2026-10-28T10:15:00Z",
    selectedRules: ["name_match", "address_match"]
  })
})
  .then(r => r.json())
  .then(data => console.log(data));

import requests

response = requests.post(
    "https://{DOMAIN}/getFusionField",
    headers={
        "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    },
    json={
        "orgId": "00D5e0000008abcEAA",
        "ruleSetId": "RS-00456",
        "orgPrefix": "dqe1",
        "calculateParent": False,
        "crt": "2026-10-28T10:15:00Z",
        "selectedRules": ["name_match", "address_match"],
    },
)
print(response.json())

<?php
$data = [
    'orgId' => '00D5e0000008abcEAA',
    'ruleSetId' => 'RS-00456',
    'orgPrefix' => 'dqe1',
    'calculateParent' => false,
    'crt' => '2026-10-28T10:15:00Z',
    'selectedRules' => ['name_match', 'address_match'],
];

$ch = curl_init("https://{DOMAIN}/getFusionField");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'DQE-Authorization: {DQE_AUTHORIZATION_KEY}',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

const axios = require('axios');

axios.post('https://{DOMAIN}/getFusionField', {
  orgId: '00D5e0000008abcEAA',
  ruleSetId: 'RS-00456',
  orgPrefix: 'dqe1',
  calculateParent: false,
  crt: '2026-10-28T10:15:00Z',
  selectedRules: ['name_match', 'address_match']
}, {
  headers: {
    'DQE-Authorization': '{DQE_AUTHORIZATION_KEY}',
    'Content-Type': 'application/json'
  }
})
  .then(response => console.log(response.data));

HttpClient client = HttpClient.newHttpClient();

String body = "{\"orgId\":\"00D5e0000008abcEAA\",\"ruleSetId\":\"RS-00456\",\"orgPrefix\":\"dqe1\",\"calculateParent\":false,\"crt\":\"2026-10-28T10:15:00Z\",\"selectedRules\":[\"name_match\",\"address_match\"]}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://{DOMAIN}/getFusionField"))
    .header("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"ruleSetId\":\"RS-00456\",\"orgPrefix\":\"dqe1\",\"calculateParent\":false,\"crt\":\"2026-10-28T10:15:00Z\",\"selectedRules\":[\"name_match\",\"address_match\"]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");

using var request = new HttpRequestMessage(HttpMethod.Post, "https://{DOMAIN}/getFusionField");
request.Headers.Add("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}");
request.Content = content;

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body := []byte(`{"orgId":"00D5e0000008abcEAA","ruleSetId":"RS-00456","orgPrefix":"dqe1","calculateParent":false,"crt":"2026-10-28T10:15:00Z","selectedRules":["name_match","address_match"]}`)

    req, _ := http.NewRequest("POST", "https://{DOMAIN}/getFusionField", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

Parameters

All fields are sent as a single JSON request body.

Field	Description	Type	Mand / Opt
orgId	The Salesforce organization ID making the request.	String	Mandatory
ruleSetId	Identifier of the data-matching rule set to retrieve fusion field definitions for.	String	Mandatory
orgPrefix	The Salesforce package namespace prefix associated with the organization's DQE One installation. Inferred from the field name only — not confirmed by the source specification.	String	Mandatory
calculateParent	Whether to include parent-record relationships when determining the available fusion fields. Inferred from the field name only — not confirmed by the source specification.	Boolean	Mandatory
crt	The created/issued-at timestamp claim for this signed request.	String	Mandatory
selectedRules	The specific rules, within the rule set, to scope the fusion-field lookup to. The source specification does not define the type of each array item.	Array	Mandatory

Response

Returns a JSON object containing the available fusion field definitions.

Key	Description	Type
error	An error message returned by the operation, if applicable. The source specification does not document when this field is populated or its possible values.	String
fields	The field identifiers available for data matching under the given rule set.	Array

Response example

Example fusion field response

{
  "error": "",
  "fields": ["FirstName", "LastName", "BillingCity"]
}

The source specification gives no example values for this schema. The values above are illustrative placeholders only.

Errors

Test the API

Click the button below to test this endpoint live in your browser.

Open console

Fusion Lookup - DQE One API

Creates (registers) a data-matching lookup configuration for a rule set.

createFusionLookup

Jump to Parameters Response Example Errors ▶ Test the API

Request

Send a JSON body to this endpoint with the DQE-Authorization header set.

POSThttps://{DOMAIN}/createFusionLookup

Code examples

Create a fusion lookup configuration

cURL JavaScript Python PHP Node.js Java C# Go

curl -X POST "https://{DOMAIN}/createFusionLookup" \
  -H "DQE-Authorization: {DQE_AUTHORIZATION_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
  "orgId": "00D5e0000008abcEAA",
  "data": { "name": "Acme Corp", "city": "Paris" },
  "orgPrefix": "dqe1",
  "ruleSetId": "RS-00456",
  "calculateParent": false,
  "crt": "2026-10-28T10:15:00Z",
  "selectedRules": ["name_match", "address_match"]
}'

fetch("https://{DOMAIN}/createFusionLookup", {
  method: "POST",
  headers: {
    "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    orgId: "00D5e0000008abcEAA",
    data: { name: "Acme Corp", city: "Paris" },
    orgPrefix: "dqe1",
    ruleSetId: "RS-00456",
    calculateParent: false,
    crt: "2026-10-28T10:15:00Z",
    selectedRules: ["name_match", "address_match"]
  })
})
  .then(r => r.json())
  .then(data => console.log(data));

import requests

response = requests.post(
    "https://{DOMAIN}/createFusionLookup",
    headers={
        "DQE-Authorization": "{DQE_AUTHORIZATION_KEY}",
    },
    json={
        "orgId": "00D5e0000008abcEAA",
        "data": {"name": "Acme Corp", "city": "Paris"},
        "orgPrefix": "dqe1",
        "ruleSetId": "RS-00456",
        "calculateParent": False,
        "crt": "2026-10-28T10:15:00Z",
        "selectedRules": ["name_match", "address_match"],
    },
)
print(response.json())

<?php
$data = [
    'orgId' => '00D5e0000008abcEAA',
    'data' => ['name' => 'Acme Corp', 'city' => 'Paris'],
    'orgPrefix' => 'dqe1',
    'ruleSetId' => 'RS-00456',
    'calculateParent' => false,
    'crt' => '2026-10-28T10:15:00Z',
    'selectedRules' => ['name_match', 'address_match'],
];

$ch = curl_init("https://{DOMAIN}/createFusionLookup");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'DQE-Authorization: {DQE_AUTHORIZATION_KEY}',
    'Content-Type: application/json',
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);

const axios = require('axios');

axios.post('https://{DOMAIN}/createFusionLookup', {
  orgId: '00D5e0000008abcEAA',
  data: { name: 'Acme Corp', city: 'Paris' },
  orgPrefix: 'dqe1',
  ruleSetId: 'RS-00456',
  calculateParent: false,
  crt: '2026-10-28T10:15:00Z',
  selectedRules: ['name_match', 'address_match']
}, {
  headers: {
    'DQE-Authorization': '{DQE_AUTHORIZATION_KEY}',
    'Content-Type': 'application/json'
  }
})
  .then(response => console.log(response.data));

HttpClient client = HttpClient.newHttpClient();

String body = "{\"orgId\":\"00D5e0000008abcEAA\",\"data\":{\"name\":\"Acme Corp\",\"city\":\"Paris\"},\"orgPrefix\":\"dqe1\",\"ruleSetId\":\"RS-00456\",\"calculateParent\":false,\"crt\":\"2026-10-28T10:15:00Z\",\"selectedRules\":[\"name_match\",\"address_match\"]}";

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://{DOMAIN}/createFusionLookup"))
    .header("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();

var json = "{\"orgId\":\"00D5e0000008abcEAA\",\"data\":{\"name\":\"Acme Corp\",\"city\":\"Paris\"},\"orgPrefix\":\"dqe1\",\"ruleSetId\":\"RS-00456\",\"calculateParent\":false,\"crt\":\"2026-10-28T10:15:00Z\",\"selectedRules\":[\"name_match\",\"address_match\"]}";
var content = new StringContent(json, Encoding.UTF8, "application/json");

using var request = new HttpRequestMessage(HttpMethod.Post, "https://{DOMAIN}/createFusionLookup");
request.Headers.Add("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}");
request.Content = content;

var response = await client.SendAsync(request);
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    body := []byte(`{"orgId":"00D5e0000008abcEAA","data":{"name":"Acme Corp","city":"Paris"},"orgPrefix":"dqe1","ruleSetId":"RS-00456","calculateParent":false,"crt":"2026-10-28T10:15:00Z","selectedRules":["name_match","address_match"]}`)

    req, _ := http.NewRequest("POST", "https://{DOMAIN}/createFusionLookup", bytes.NewBuffer(body))
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("DQE-Authorization", "{DQE_AUTHORIZATION_KEY}")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    respBody, _ := io.ReadAll(resp.Body)
    fmt.Println(string(respBody))
}

Parameters

All fields are sent as a single JSON request body.

Field	Description	Type	Mand / Opt
orgId	The Salesforce organization ID making the request.	String	Mandatory
data	The data record to register under the fusion lookup configuration. The source specification does not define the properties of this object.	Object	Mandatory
orgPrefix	The Salesforce package namespace prefix associated with the organization's DQE One installation. Inferred from the field name only — not confirmed by the source specification.	String	Mandatory
ruleSetId	Identifier of the data-matching rule set this fusion lookup configuration is being created for.	String	Mandatory
calculateParent	Whether to include parent-record relationships when creating this fusion lookup configuration. Inferred from the field name only — not confirmed by the source specification.	Boolean	Mandatory
crt	The created/issued-at timestamp claim for this signed request.	String	Mandatory
selectedRules	The specific rules, within the rule set, that this fusion lookup configuration applies to. The source specification does not define the type of each array item.	Array	Mandatory

Response

Returns a JSON object describing the created fusion lookup record(s).

Key	Description	Type
record	An array of objects representing the created/registered fusion lookup record(s). The source specification does not define the shape of each object.	Array

Response example

Example fusion lookup response

{
  "record": [
    { "id": "FL-00789", "status": "created" }
  ]
}

The source specification gives no example values for this schema. The values above are illustrative placeholders only.

Errors

Test the API

Click the button below to test this endpoint live in your browser.

Open console

DQE One API — Data Configuration

getDCMetadata

Request

Code examples

Parameters

Response

Response example

Errors

Test the API

getFusionField

Request

Code examples

Parameters

Response

Response example

Errors

Test the API

createFusionLookup

Request

Code examples

Parameters

Response

Response example

Errors

Test the API

See also

Was this article helpful?

Previous article

Next article