Create data list

curl --request POST \
  --url http://api.gu1.ai/data-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "description": "<string>",
  "source": "<string>",
  "config": {},
  "fieldMappings": {},
  "priority": 123,
  "isGlobal": true
}
'

import requests

url = "http://api.gu1.ai/data-lists"

payload = {
    "name": "<string>",
    "type": "<string>",
    "description": "<string>",
    "source": "<string>",
    "config": {},
    "fieldMappings": {},
    "priority": 123,
    "isGlobal": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    description: '<string>',
    source: '<string>',
    config: {},
    fieldMappings: {},
    priority: 123,
    isGlobal: true
  })
};

fetch('http://api.gu1.ai/data-lists', 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 => "http://api.gu1.ai/data-lists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'description' => '<string>',
    'source' => '<string>',
    'config' => [
        
    ],
    'fieldMappings' => [
        
    ],
    'priority' => 123,
    'isGlobal' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "http://api.gu1.ai/data-lists"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://api.gu1.ai/data-lists")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/data-lists")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}"

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

POST

data-lists

Create data list

curl --request POST \
  --url http://api.gu1.ai/data-lists \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "<string>",
  "description": "<string>",
  "source": "<string>",
  "config": {},
  "fieldMappings": {},
  "priority": 123,
  "isGlobal": true
}
'

import requests

url = "http://api.gu1.ai/data-lists"

payload = {
    "name": "<string>",
    "type": "<string>",
    "description": "<string>",
    "source": "<string>",
    "config": {},
    "fieldMappings": {},
    "priority": 123,
    "isGlobal": True
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    type: '<string>',
    description: '<string>',
    source: '<string>',
    config: {},
    fieldMappings: {},
    priority: 123,
    isGlobal: true
  })
};

fetch('http://api.gu1.ai/data-lists', 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 => "http://api.gu1.ai/data-lists",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'type' => '<string>',
    'description' => '<string>',
    'source' => '<string>',
    'config' => [
        
    ],
    'fieldMappings' => [
        
    ],
    'priority' => 123,
    'isGlobal' => true
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

	url := "http://api.gu1.ai/data-lists"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

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

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

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("http://api.gu1.ai/data-lists")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("http://api.gu1.ai/data-lists")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"type\": \"<string>\",\n  \"description\": \"<string>\",\n  \"source\": \"<string>\",\n  \"config\": {},\n  \"fieldMappings\": {},\n  \"priority\": 123,\n  \"isGlobal\": true\n}"

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

Overview

Creates a new data list for the organization. Use type: "custom" for a generic list you will reference by UUID in rules.

Endpoint

POST https://api.gu1.ai/data-lists

Authentication

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Request Body

string

required

Display name (1–200 characters). Shown in the dashboard (list catalog, selectors, headers) so your team can identify the list; it does not affect how rules match items.

string

required

List type enum, including custom, company_blocklist, document_blocklist, keyword_list, ip_blocklist, and others supported by the platform.

string

Optional description (max 1000 characters). Use for internal context (owner, refresh policy, intended use case); visible in the dashboard where the product shows list details. Not used by the matching engine.

string

required

Origin of data, e.g. manual_entry, api_integration, custom_upload, internal, etc.

object

Optional: autoSync, syncFrequency, externalUrl, apiKey, visibleItemDataColumns, etc.

object

Optional string-to-string map for ingestion mappings.

number

default:"50"

Priority 1–100.

boolean

Reserved for platform use; tenant clients normally omit or set false.

Example

{
  "name": "High-risk merchants",
  "description": "Internal blocklist for KYB rules",
  "type": "custom",
  "source": "api_integration"
}

Response

201 with success, data (includes list id), and timing metadata on success.

⌘I

Getting Started

SDK

Use Cases

Webhooks

Workflows

Monitoring (entities)

Person

Messaging

Company

Transactions

Devices

Events

Know Your Customer (KYC)

Payment Methods

Rules

Custom lists

Risk Matrix

Alerts

Investigations

Data Ingestion

Bulk imports

Documents

Enrichment

AML Crypto

Services

Integrations

Interactive Tutorials

Create data list

Overview

Endpoint

Authentication

Request Body

Example

Response

​Overview

​Endpoint

​Authentication

​Request Body

​Example

​Response

Overview

Endpoint

Authentication

Request Body

Example

Response