Get the default resolution rule

curl --request GET \
  --url https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "order_index": 123,
  "description": "<string>",
  "system": true,
  "enabled": true
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "error_code": "<string>",
  "timestamp": "<string>",
  "retryable": false,
  "retry_after": 123,
  "owner_action_required": true,
  "details": "<unknown>"
}

Resolver

Get the default resolution rule

Return the implicit, system-managed default rule — the baseline fallback the resolver applies when no user-created rule matches a scan (a redirect to the brand’s Closient-hosted page, C-3956). The default rule is a sentinel, not a stored row: it has no id and cannot be created, edited, deleted, or reordered. Clients render it at the bottom of the rules list, below all user rules, and use system: true to flag it as non-editable. Returns 404 if the organization doesn’t exist or the caller lacks VIEW permission. The default is the same for every organization, so this endpoint is unfiltered.

GET

resolver

api

organizations

{organization_id}

resolution-rules

default

Get the default resolution rule

curl --request GET \
  --url https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default"

headers = {"X-API-Key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://www.closient.com/resolver/api/v1/organizations/{organization_id}/resolution-rules/default")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "order_index": 123,
  "description": "<string>",
  "system": true,
  "enabled": true
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "error_code": "<string>",
  "timestamp": "<string>",
  "retryable": false,
  "retry_after": 123,
  "owner_action_required": true,
  "details": "<unknown>"
}

Authorizations

X-API-Key

string

header

required

Path Parameters

organization_id

string<shortuuid>

required

UUID of the organization. Caller must have VIEW permission.

Required string length: 22

Pattern: ^[23456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz]{22}$

Response

The implicit, system-managed default rule (C-3336).

Represents the baseline fallback the resolver always applies when no user-created rule matches a scan: a redirect to the brand's Closient-hosted page (C-3956), falling back to the product page when the brand has no published page. It is a sentinel, not a database row — it has no id, cannot be created, edited, deleted, or reordered, and exists purely so the brand portal can render it at the bottom of the rules list and clients can explain the fallback to users.

scope_type

enum<string>

required

Always BRAND — the implicit host rule applies at the brand scope as the last resort.

Available options:

ORGANIZATION,

BRAND,

PRODUCT,

BATCH,

SERIAL

destination_type

enum<string>

required

Always HOSTED_PAGE — the fallback redirects to the brand's hosted page.

Available options:

HOSTED_PAGE,

CUSTOM_URL

order_index

integer

required

Sentinel ordering value that keeps the default sorted after every user rule.

description

string

required

Human-readable explanation of the fallback behaviour, suitable for a tooltip / info panel.

system

boolean

default:true

Always true — discriminates the default rule from user-managed rules.

enabled

boolean

default:true

Always true — the fallback can't be disabled.

Create resolution rule Get resolution rule

Overview

Account

Products

Brands

Locations

Retailers

Search

GS1 Digital Link

EPCIS 2.0

Integrations

Billing

Scanner

Compliance

Certifications

Sustainability

Notifications

Advertising

Dashboard

Content

Signals

Get the default resolution rule

Authorizations

Path Parameters

Response