Create a Case

curl --request POST \
  --url https://api.youverify.co/v2/api/cases \
  --header 'Content-Type: application/json' \
  --header 'token: <api-key>' \
  --data @- <<EOF
{
  "caseTitle": "KYC data Mismatch",
  "caseType": "KYC",
  "description": "The case was created because there's a complete mismatch between the NIN and BVN data of the client.",
  "severity": "High",
  "entityId": "6880a452495dce07d2f7ff5a",
  "investigator": {
    "investigatorId": "681d7b32cd275833cb856fff"
  },
  "linkedIssues": [
    {
      "issueId": "6880f7d527309cf76eb5db2e",
      "issueType": "Activity",
      "status": "Mismatch"
    }
  ],
  "caseStage": [
    {
      "stage": "Investigation",
      "level": "LV1",
      "tasks": [
        {
          "task": "Investigate KYC verification"
        },
        {
          "task": "Gather evidences, and add them to the case."
        },
        {
          "task": "Confirm if entities are same and why there's a mismatch"
        }
      ]
    },
    {
      "stage": "Analysis",
      "level": "LV2",
      "tasks": [
        {
          "task": "Gather evidences"
        },
        {
          "task": "Analyse evidences"
        },
        {
          "task": "Review analysis"
        }
      ]
    },
    {
      "stage": "Filing",
      "level": "LV3",
      "tasks": [
        {
          "task": "File report"
        },
        {
          "task": "Follow up filing"
        },
        {
          "task": "Confirm case filed successfully"
        }
      ]
    }
  ]
}
EOF

import requests

url = "https://api.youverify.co/v2/api/cases"

payload = {
    "caseTitle": "KYC data Mismatch",
    "caseType": "KYC",
    "description": "The case was created because there's a complete mismatch between the NIN and BVN data of the client.",
    "severity": "High",
    "entityId": "6880a452495dce07d2f7ff5a",
    "investigator": { "investigatorId": "681d7b32cd275833cb856fff" },
    "linkedIssues": [
        {
            "issueId": "6880f7d527309cf76eb5db2e",
            "issueType": "Activity",
            "status": "Mismatch"
        }
    ],
    "caseStage": [
        {
            "stage": "Investigation",
            "level": "LV1",
            "tasks": [{ "task": "Investigate KYC verification" }, { "task": "Gather evidences, and add them to the case." }, { "task": "Confirm if entities are same and why there's a mismatch" }]
        },
        {
            "stage": "Analysis",
            "level": "LV2",
            "tasks": [{ "task": "Gather evidences" }, { "task": "Analyse evidences" }, { "task": "Review analysis" }]
        },
        {
            "stage": "Filing",
            "level": "LV3",
            "tasks": [{ "task": "File report" }, { "task": "Follow up filing" }, { "task": "Confirm case filed successfully" }]
        }
    ]
}
headers = {
    "token": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

const options = {
  method: 'POST',
  headers: {token: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    caseTitle: 'KYC data Mismatch',
    caseType: 'KYC',
    description: 'The case was created because there\'s a complete mismatch between the NIN and BVN data of the client.',
    severity: 'High',
    entityId: '6880a452495dce07d2f7ff5a',
    investigator: {investigatorId: '681d7b32cd275833cb856fff'},
    linkedIssues: [
      {issueId: '6880f7d527309cf76eb5db2e', issueType: 'Activity', status: 'Mismatch'}
    ],
    caseStage: [
      {
        stage: 'Investigation',
        level: 'LV1',
        tasks: [
          {task: 'Investigate KYC verification'},
          {task: 'Gather evidences, and add them to the case.'},
          {task: 'Confirm if entities are same and why there\'s a mismatch'}
        ]
      },
      {
        stage: 'Analysis',
        level: 'LV2',
        tasks: [
          {task: 'Gather evidences'},
          {task: 'Analyse evidences'},
          {task: 'Review analysis'}
        ]
      },
      {
        stage: 'Filing',
        level: 'LV3',
        tasks: [
          {task: 'File report'},
          {task: 'Follow up filing'},
          {task: 'Confirm case filed successfully'}
        ]
      }
    ]
  })
};

fetch('https://api.youverify.co/v2/api/cases', 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://api.youverify.co/v2/api/cases",
  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([
    'caseTitle' => 'KYC data Mismatch',
    'caseType' => 'KYC',
    'description' => 'The case was created because there\'s a complete mismatch between the NIN and BVN data of the client.',
    'severity' => 'High',
    'entityId' => '6880a452495dce07d2f7ff5a',
    'investigator' => [
        'investigatorId' => '681d7b32cd275833cb856fff'
    ],
    'linkedIssues' => [
        [
                'issueId' => '6880f7d527309cf76eb5db2e',
                'issueType' => 'Activity',
                'status' => 'Mismatch'
        ]
    ],
    'caseStage' => [
        [
                'stage' => 'Investigation',
                'level' => 'LV1',
                'tasks' => [
                                [
                                                                'task' => 'Investigate KYC verification'
                                ],
                                [
                                                                'task' => 'Gather evidences, and add them to the case.'
                                ],
                                [
                                                                'task' => 'Confirm if entities are same and why there\'s a mismatch'
                                ]
                ]
        ],
        [
                'stage' => 'Analysis',
                'level' => 'LV2',
                'tasks' => [
                                [
                                                                'task' => 'Gather evidences'
                                ],
                                [
                                                                'task' => 'Analyse evidences'
                                ],
                                [
                                                                'task' => 'Review analysis'
                                ]
                ]
        ],
        [
                'stage' => 'Filing',
                'level' => 'LV3',
                'tasks' => [
                                [
                                                                'task' => 'File report'
                                ],
                                [
                                                                'task' => 'Follow up filing'
                                ],
                                [
                                                                'task' => 'Confirm case filed successfully'
                                ]
                ]
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "token: <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://api.youverify.co/v2/api/cases"

	payload := strings.NewReader("{\n  \"caseTitle\": \"KYC data Mismatch\",\n  \"caseType\": \"KYC\",\n  \"description\": \"The case was created because there's a complete mismatch between the NIN and BVN data of the client.\",\n  \"severity\": \"High\",\n  \"entityId\": \"6880a452495dce07d2f7ff5a\",\n  \"investigator\": {\n    \"investigatorId\": \"681d7b32cd275833cb856fff\"\n  },\n  \"linkedIssues\": [\n    {\n      \"issueId\": \"6880f7d527309cf76eb5db2e\",\n      \"issueType\": \"Activity\",\n      \"status\": \"Mismatch\"\n    }\n  ],\n  \"caseStage\": [\n    {\n      \"stage\": \"Investigation\",\n      \"level\": \"LV1\",\n      \"tasks\": [\n        {\n          \"task\": \"Investigate KYC verification\"\n        },\n        {\n          \"task\": \"Gather evidences, and add them to the case.\"\n        },\n        {\n          \"task\": \"Confirm if entities are same and why there's a mismatch\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Analysis\",\n      \"level\": \"LV2\",\n      \"tasks\": [\n        {\n          \"task\": \"Gather evidences\"\n        },\n        {\n          \"task\": \"Analyse evidences\"\n        },\n        {\n          \"task\": \"Review analysis\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Filing\",\n      \"level\": \"LV3\",\n      \"tasks\": [\n        {\n          \"task\": \"File report\"\n        },\n        {\n          \"task\": \"Follow up filing\"\n        },\n        {\n          \"task\": \"Confirm case filed successfully\"\n        }\n      ]\n    }\n  ]\n}")

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

	req.Header.Add("token", "<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://api.youverify.co/v2/api/cases")
  .header("token", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"caseTitle\": \"KYC data Mismatch\",\n  \"caseType\": \"KYC\",\n  \"description\": \"The case was created because there's a complete mismatch between the NIN and BVN data of the client.\",\n  \"severity\": \"High\",\n  \"entityId\": \"6880a452495dce07d2f7ff5a\",\n  \"investigator\": {\n    \"investigatorId\": \"681d7b32cd275833cb856fff\"\n  },\n  \"linkedIssues\": [\n    {\n      \"issueId\": \"6880f7d527309cf76eb5db2e\",\n      \"issueType\": \"Activity\",\n      \"status\": \"Mismatch\"\n    }\n  ],\n  \"caseStage\": [\n    {\n      \"stage\": \"Investigation\",\n      \"level\": \"LV1\",\n      \"tasks\": [\n        {\n          \"task\": \"Investigate KYC verification\"\n        },\n        {\n          \"task\": \"Gather evidences, and add them to the case.\"\n        },\n        {\n          \"task\": \"Confirm if entities are same and why there's a mismatch\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Analysis\",\n      \"level\": \"LV2\",\n      \"tasks\": [\n        {\n          \"task\": \"Gather evidences\"\n        },\n        {\n          \"task\": \"Analyse evidences\"\n        },\n        {\n          \"task\": \"Review analysis\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Filing\",\n      \"level\": \"LV3\",\n      \"tasks\": [\n        {\n          \"task\": \"File report\"\n        },\n        {\n          \"task\": \"Follow up filing\"\n        },\n        {\n          \"task\": \"Confirm case filed successfully\"\n        }\n      ]\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.youverify.co/v2/api/cases")

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

request = Net::HTTP::Post.new(url)
request["token"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"caseTitle\": \"KYC data Mismatch\",\n  \"caseType\": \"KYC\",\n  \"description\": \"The case was created because there's a complete mismatch between the NIN and BVN data of the client.\",\n  \"severity\": \"High\",\n  \"entityId\": \"6880a452495dce07d2f7ff5a\",\n  \"investigator\": {\n    \"investigatorId\": \"681d7b32cd275833cb856fff\"\n  },\n  \"linkedIssues\": [\n    {\n      \"issueId\": \"6880f7d527309cf76eb5db2e\",\n      \"issueType\": \"Activity\",\n      \"status\": \"Mismatch\"\n    }\n  ],\n  \"caseStage\": [\n    {\n      \"stage\": \"Investigation\",\n      \"level\": \"LV1\",\n      \"tasks\": [\n        {\n          \"task\": \"Investigate KYC verification\"\n        },\n        {\n          \"task\": \"Gather evidences, and add them to the case.\"\n        },\n        {\n          \"task\": \"Confirm if entities are same and why there's a mismatch\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Analysis\",\n      \"level\": \"LV2\",\n      \"tasks\": [\n        {\n          \"task\": \"Gather evidences\"\n        },\n        {\n          \"task\": \"Analyse evidences\"\n        },\n        {\n          \"task\": \"Review analysis\"\n        }\n      ]\n    },\n    {\n      \"stage\": \"Filing\",\n      \"level\": \"LV3\",\n      \"tasks\": [\n        {\n          \"task\": \"File report\"\n        },\n        {\n          \"task\": \"Follow up filing\"\n        },\n        {\n          \"task\": \"Confirm case filed successfully\"\n        }\n      ]\n    }\n  ]\n}"

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

{
  "success": true,
  "statusCode": 201,
  "message": "Case created successfully!",
  "data": {
    "caseTitle": "KYC data Mismatch",
    "status": "Opened",
    "caseType": "KYC",
    "severity": "High",
    "parentId": null,
    "businessId": "681d7b30cd275833cb856ff8",
    "entityId": "6880a452495dce07d2f7ff5a",
    "description": "The case was created because there's a complete mismatch between the NIN and BVN data of the client.",
    "evidences": [],
    "linkedIssues": [
      {
        "issueId": "6880f7d527309cf76eb5db2e",
        "issueType": "Activity",
        "dateLinked": null,
        "status": "Mismatch"
      },
      {
        "issueId": "6880f7d527309cf76eb5db2e",
        "issueType": "Transaction",
        "dateLinked": null,
        "status": "Mismatch"
      },
      {
        "issueId": "6880f7d527309cf76eb5db2e",
        "issueType": "Alert",
        "dateLinked": null,
        "status": "Mismatch"
      }
    ],
    "caseStage": [
      {
        "stage": "Investigation",
        "level": "LV1",
        "investigatorId": "681d7b32cd275833cb856fff",
        "investigatorName": "Jaymee Bottomore",
        "notes": [],
        "isReassigned": false,
        "previousInvestigators": [],
        "tasks": [
          {
            "task": "Investigate KYC verification",
            "isCompleted": false
          },
          {
            "task": "Gather evidences, and add them to the case.",
            "isCompleted": false
          },
          {
            "task": "Confirm if entities are same and why there's a mismatch",
            "isCompleted": false
          }
        ],
        "_id": "68945a37a52eb93b87f827fa"
      }
    ],
    "activities": [
      {
        "event": "Case Created",
        "activity": "Case created by Jaymee Bottomore",
        "createdBy": "Jaymee Bottomore",
        "userId": "681d7b30cd275833cb856ff8",
        "eventDateTime": "2025-08-07T07:48:07.145Z",
        "_id": "68945a37a52eb93b87f827fb"
      }
    ],
    "isDeleted": false,
    "comments": [],
    "createdAt": "2025-08-07T07:48:07.165Z",
    "lastModifiedAt": "2025-08-07T07:48:07.165Z",
    "_createdAt": "2025-08-07T08:48:077+01:00",
    "_lastModifiedAt": "2025-08-07T08:48:077+01:00",
    "object": "case",
    "id": "cas_68945a37a52eb93b87f827f9"
  },
  "links": []
}

{
  "success": false,
  "statusCode": 401,
  "message": "Permission denied",
  "name": "UnauthorizedError",
  "data": {}
}

{
  "success": false,
  "statusCode": 402,
  "message": "Insufficient fund",
  "name": "PaymentRequiredError",
  "data": {}
}

{
  "success": false,
  "statusCode": 404,
  "message": "You have attempted to get a resource that does not exist.",
  "name": "ResourceNotFoundError",
  "data": {}
}

{
  "success": false,
  "statusCode": 429,
  "message": "Too many requests",
  "name": "RateLimitError",
  "data": {}
}

{
  "success": false,
  "statusCode": 500,
  "message": "Internal Server Error",
  "name": "Error",
  "data": {}
}