Create Case
curl --request POST \
--url https://sigmaprod.sabipay.com/api/v1/case-management/create \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--header 'apiSecret: <api-key>' \
--data '
{
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"assignedTo": "64a9f1c2d3e4b5a6c7d8e9f0",
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": [
"Review customer transaction history for the last 90 days",
"Verify source of funds documentation",
"Check customer against internal watchlist",
"Record final decision with supporting notes"
]
}
'import requests
url = "https://sigmaprod.sabipay.com/api/v1/case-management/create"
payload = {
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"assignedTo": "64a9f1c2d3e4b5a6c7d8e9f0",
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": ["Review customer transaction history for the last 90 days", "Verify source of funds documentation", "Check customer against internal watchlist", "Record final decision with supporting notes"]
}
headers = {
"apiKey": "<api-key>",
"apiSecret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
apiKey: '<api-key>',
apiSecret: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
module: 'transaction-monitoring',
record: {id: '64f1a2b3c4d5e6f7a8b9c0d1', type: 'transaction', name: 'TXN-00123456'},
title: 'High-value transaction requiring review',
description: 'A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.',
priority: 'high',
assignedTo: '64a9f1c2d3e4b5a6c7d8e9f0',
dueDate: '2026-04-25T23:59:59.000Z',
tasks: [
'Review customer transaction history for the last 90 days',
'Verify source of funds documentation',
'Check customer against internal watchlist',
'Record final decision with supporting notes'
]
})
};
fetch('https://sigmaprod.sabipay.com/api/v1/case-management/create', 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://sigmaprod.sabipay.com/api/v1/case-management/create",
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([
'module' => 'transaction-monitoring',
'record' => [
'id' => '64f1a2b3c4d5e6f7a8b9c0d1',
'type' => 'transaction',
'name' => 'TXN-00123456'
],
'title' => 'High-value transaction requiring review',
'description' => 'A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.',
'priority' => 'high',
'assignedTo' => '64a9f1c2d3e4b5a6c7d8e9f0',
'dueDate' => '2026-04-25T23:59:59.000Z',
'tasks' => [
'Review customer transaction history for the last 90 days',
'Verify source of funds documentation',
'Check customer against internal watchlist',
'Record final decision with supporting notes'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>",
"apiSecret: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sigmaprod.sabipay.com/api/v1/case-management/create"
payload := strings.NewReader("{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("apiSecret", "<api-key>")
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("https://sigmaprod.sabipay.com/api/v1/case-management/create")
.header("apiKey", "<api-key>")
.header("apiSecret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sigmaprod.sabipay.com/api/v1/case-management/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["apiSecret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"message": "Case created successfully",
"data": {
"_id": "6801c4f2a3b7d8e9f1c2d3e4",
"businessProfile": "63f0a1b2c3d4e5f6a7b8c9d0",
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"status": "open",
"assignedTo": {
"_id": "64a9f1c2d3e4b5a6c7d8e9f0",
"firstName": "Amaka",
"lastName": "Osei"
},
"assignedBy": {
"_id": "63e8b0a1c2d3f4e5a6b7c8d9",
"firstName": "Tunde",
"lastName": "Adeyemi"
},
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": [
{
"_id": "6801c4f2a3b7d8e9f1c2d3e5",
"text": "Review customer transaction history for the last 90 days",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e6",
"text": "Verify source of funds documentation",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e7",
"text": "Check customer against internal watchlist",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e8",
"text": "Record final decision with supporting notes",
"status": false
}
],
"comments": [],
"attachments": [],
"isEscalated": false,
"log": [
{
"_id": "6801c4f2a3b7d8e9f1c2d3e9",
"status": "open",
"message": "Case created",
"user": {
"_id": "63e8b0a1c2d3f4e5a6b7c8d9",
"firstName": "Tunde",
"lastName": "Adeyemi"
},
"date": "2026-04-22T09:15:42.000Z"
}
],
"createdAt": "2026-04-22T09:15:42.000Z",
"updatedAt": "2026-04-22T09:15:42.000Z"
}
}{
"message": "assignedTo is required"
}{
"message": "Invalid API credentials"
}{
"message": "The specified user does not have permission to be assigned cases"
}Case Management
Create Case
POST api/v1/case-management/create
Create Case
curl --request POST \
--url https://sigmaprod.sabipay.com/api/v1/case-management/create \
--header 'Content-Type: application/json' \
--header 'apiKey: <api-key>' \
--header 'apiSecret: <api-key>' \
--data '
{
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"assignedTo": "64a9f1c2d3e4b5a6c7d8e9f0",
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": [
"Review customer transaction history for the last 90 days",
"Verify source of funds documentation",
"Check customer against internal watchlist",
"Record final decision with supporting notes"
]
}
'import requests
url = "https://sigmaprod.sabipay.com/api/v1/case-management/create"
payload = {
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"assignedTo": "64a9f1c2d3e4b5a6c7d8e9f0",
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": ["Review customer transaction history for the last 90 days", "Verify source of funds documentation", "Check customer against internal watchlist", "Record final decision with supporting notes"]
}
headers = {
"apiKey": "<api-key>",
"apiSecret": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
apiKey: '<api-key>',
apiSecret: '<api-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
module: 'transaction-monitoring',
record: {id: '64f1a2b3c4d5e6f7a8b9c0d1', type: 'transaction', name: 'TXN-00123456'},
title: 'High-value transaction requiring review',
description: 'A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.',
priority: 'high',
assignedTo: '64a9f1c2d3e4b5a6c7d8e9f0',
dueDate: '2026-04-25T23:59:59.000Z',
tasks: [
'Review customer transaction history for the last 90 days',
'Verify source of funds documentation',
'Check customer against internal watchlist',
'Record final decision with supporting notes'
]
})
};
fetch('https://sigmaprod.sabipay.com/api/v1/case-management/create', 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://sigmaprod.sabipay.com/api/v1/case-management/create",
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([
'module' => 'transaction-monitoring',
'record' => [
'id' => '64f1a2b3c4d5e6f7a8b9c0d1',
'type' => 'transaction',
'name' => 'TXN-00123456'
],
'title' => 'High-value transaction requiring review',
'description' => 'A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.',
'priority' => 'high',
'assignedTo' => '64a9f1c2d3e4b5a6c7d8e9f0',
'dueDate' => '2026-04-25T23:59:59.000Z',
'tasks' => [
'Review customer transaction history for the last 90 days',
'Verify source of funds documentation',
'Check customer against internal watchlist',
'Record final decision with supporting notes'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"apiKey: <api-key>",
"apiSecret: <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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://sigmaprod.sabipay.com/api/v1/case-management/create"
payload := strings.NewReader("{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("apiKey", "<api-key>")
req.Header.Add("apiSecret", "<api-key>")
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("https://sigmaprod.sabipay.com/api/v1/case-management/create")
.header("apiKey", "<api-key>")
.header("apiSecret", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://sigmaprod.sabipay.com/api/v1/case-management/create")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["apiKey"] = '<api-key>'
request["apiSecret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"module\": \"transaction-monitoring\",\n \"record\": {\n \"id\": \"64f1a2b3c4d5e6f7a8b9c0d1\",\n \"type\": \"transaction\",\n \"name\": \"TXN-00123456\"\n },\n \"title\": \"High-value transaction requiring review\",\n \"description\": \"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.\",\n \"priority\": \"high\",\n \"assignedTo\": \"64a9f1c2d3e4b5a6c7d8e9f0\",\n \"dueDate\": \"2026-04-25T23:59:59.000Z\",\n \"tasks\": [\n \"Review customer transaction history for the last 90 days\",\n \"Verify source of funds documentation\",\n \"Check customer against internal watchlist\",\n \"Record final decision with supporting notes\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"message": "Case created successfully",
"data": {
"_id": "6801c4f2a3b7d8e9f1c2d3e4",
"businessProfile": "63f0a1b2c3d4e5f6a7b8c9d0",
"module": "transaction-monitoring",
"record": {
"id": "64f1a2b3c4d5e6f7a8b9c0d1",
"type": "transaction",
"name": "TXN-00123456"
},
"title": "High-value transaction requiring review",
"description": "A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release.",
"priority": "high",
"status": "open",
"assignedTo": {
"_id": "64a9f1c2d3e4b5a6c7d8e9f0",
"firstName": "Amaka",
"lastName": "Osei"
},
"assignedBy": {
"_id": "63e8b0a1c2d3f4e5a6b7c8d9",
"firstName": "Tunde",
"lastName": "Adeyemi"
},
"dueDate": "2026-04-25T23:59:59.000Z",
"tasks": [
{
"_id": "6801c4f2a3b7d8e9f1c2d3e5",
"text": "Review customer transaction history for the last 90 days",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e6",
"text": "Verify source of funds documentation",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e7",
"text": "Check customer against internal watchlist",
"status": false
},
{
"_id": "6801c4f2a3b7d8e9f1c2d3e8",
"text": "Record final decision with supporting notes",
"status": false
}
],
"comments": [],
"attachments": [],
"isEscalated": false,
"log": [
{
"_id": "6801c4f2a3b7d8e9f1c2d3e9",
"status": "open",
"message": "Case created",
"user": {
"_id": "63e8b0a1c2d3f4e5a6b7c8d9",
"firstName": "Tunde",
"lastName": "Adeyemi"
},
"date": "2026-04-22T09:15:42.000Z"
}
],
"createdAt": "2026-04-22T09:15:42.000Z",
"updatedAt": "2026-04-22T09:15:42.000Z"
}
}{
"message": "assignedTo is required"
}{
"message": "Invalid API credentials"
}{
"message": "The specified user does not have permission to be assigned cases"
}The
assignedTo field must be a valid user ID from your Sigma account. You can find user IDs under Account → Team Members & Roles in the dashboard. The user must have the can assign case permission to be assigned a case.Body
application/json
A short, descriptive title for the case. Shown in the case list.
Example:
"High-value transaction requiring review"
A detailed description of why the case was opened and what needs to be investigated.
Example:
"A transfer of ₦4,500,000 was flagged by the fraud scoring engine with a score of 87. The customer has no prior history of transactions of this size. Requires manual review before release."
The urgency level of the case.
Available options:
low, medium, high Example:
"high"
The ID of the team member responsible for this case. Must be a valid user in your Sigma account with the can assign case permission.
Example:
"64a9f1c2d3e4b5a6c7d8e9f0"
The Sigma product area this case relates to. Use one of the standard module values or omit and provide customModule instead.
Available options:
transaction-monitoring, aml, cdd, kyc, reporting Example:
"transaction-monitoring"
A custom module name for cases that do not fit a standard Sigma product module. Provide either module or customModule, not both.
Example:
"internal-audit"
A reference to an existing Sigma record to link to this case.
Show child attributes
Show child attributes
The deadline for resolving this case. ISO 8601 format. Cases past their due date are flagged as overdue in analytics.
Example:
"2026-04-25T23:59:59.000Z"
An optional checklist of steps the investigator should complete. Each string becomes a task item on the case.
Example:
[
"Review customer transaction history for the last 90 days",
"Verify source of funds documentation",
"Record final decision with supporting notes"
]
File paths for any attachments to include with the case at creation.
Example:
[]
The ID of a senior team member to escalate this case to, if needed.
Example:
null
⌘I