Supprimer une checklist

Supprimez une Check List que vous possédez. L’API renvoie le document supprimé dans { data }. Un ObjectId invalide, une liste absente ou une liste appartenant à un autre client renvoie 404.

La suppression n’exécute pas de consultations et ne consomme pas de crédits. L’historique catalogue et les jobs SmartBatch qui ont utilisé les mêmes codes de features ne sont pas retirés.

Endpoint

DELETE https://api.verifik.co/v2/check-lists/{id}

Retire la liste de la collection du client et renvoie le document qui a été supprimé. Après cet appel, GET / PUT / DELETE sur le même id renvoient 404.

Headers

Name	Value
Content-Type	application/json
Authorization	Bearer <token>

Le jeton doit être un JWT client. Un jeton sans clientId renvoie 403.

Parameters

Name	Type	Required	Description
id	string	Yes	ObjectId Check List issu de la création ou de la liste.

Request

Node.js

const fetch = require("node-fetch");

async function run() {
    const id = "6aa224c87034a338385c28c0";
    const res = await fetch(`https://api.verifik.co/v2/check-lists/${id}`, {
        method: "DELETE",
        headers: {
            "Content-Type": "application/json",
            Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
        },
    });
    console.log(await res.json());
}

run();

PHP

<?php
$id = "6aa224c87034a338385c28c0";
$ch = curl_init("https://api.verifik.co/v2/check-lists/" . $id);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
echo curl_exec($ch);

Python

import os, requests

check_list_id = "6aa224c87034a338385c28c0"
url = f"https://api.verifik.co/v2/check-lists/{check_list_id}"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
r = requests.delete(url, headers=headers)
print(r.json())

Go

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "os"
)

func main() {
    id := "6aa224c87034a338385c28c0"
    req, _ := http.NewRequest("DELETE", "https://api.verifik.co/v2/check-lists/"+id, nil)
    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Authorization", "Bearer "+os.Getenv("VERIFIK_TOKEN"))
    resp, _ := http.DefaultClient.Do(req)
    defer resp.Body.Close()
    var out map[string]interface{}
    json.NewDecoder(resp.Body).Decode(&out)
    fmt.Println(out)
}

Response

200

{
    "data": {
        "_id": "6aa224c87034a338385c28c0",
        "client": "507f1f77bcf86cd799439013",
        "name": "KYC Colombia",
        "countries": ["Colombia", "Chile"],
        "domains": ["people"],
        "featureCodes": ["co-cedula"],
        "status": "draft",
        "createdAt": "2026-09-10T03:32:00.000Z",
        "updatedAt": "2026-09-10T03:33:00.000Z"
    }
}

403

{
    "message": "Client context required",
    "code": "Forbidden"
}

404

{
    "message": "check_list_not_found",
    "code": "check_list_not_found"
}

Notes

• Le corps 200 est le document supprimé, pas un objet vide.
• Les ObjectId invalides et les listes d’autres clients renvoient tous les deux 404 (check_list_not_found).
• La suppression ne consomme pas de crédits et n’annule pas le travail catalogue ou SmartBatch.
• Il n’y a pas d’endpoint d’exécution de checklist. Voir Check List et SmartBatch.