チェックリスト一覧

認証済みクライアントに保存された Check List を一覧します。結果はそのクライアントに限定され、updatedAt の降順（新しい順）で並びます。この呼び出しは照会を実行せず、クレジットも消費しません。

名前で絞り込むには search（または text）を使います。ページネーションのメタデータが必要なときは page を送ってください。page を省略すると、一致する配列だけが data に入り、total / pages フィールドはありません。

Endpoint

GET https://api.verifik.co/v2/check-lists

クライアントの保存済みリストを返します。各項目には name、countries、domains、featureCodes、status が含まれます。page がある場合、応答には total、limit、page、pages も含まれます。

Headers

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

トークンは クライアント JWT である必要があります。clientId のないトークンは 403 を返します。

Parameters

Name	Type	Required	Description
page	integer	No	指定すると API がページネーションし、total、limit、page、pages を返します。省略すると一致する配列だけが返ります。
perPage	integer	No	ページサイズ。limit のエイリアス。page を省略しても適用されます。
limit	integer	No	ページサイズ。perPage のエイリアス。
search	string	No	大文字小文字を区別しない名前フィルタ。
text	string	No	search のエイリアス。

Request

Node.js

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

async function run() {
    const res = await fetch("https://api.verifik.co/v2/check-lists?page=1&perPage=20&search=Colombia", {
        method: "GET",
        headers: {
            "Content-Type": "application/json",
            Authorization: `Bearer ${process.env.VERIFIK_TOKEN}`,
        },
    });
    console.log(await res.json());
}

run();

PHP

<?php
$ch = curl_init("https://api.verifik.co/v2/check-lists?page=1&perPage=20&search=Colombia");
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
    "Authorization: Bearer " . getenv("VERIFIK_TOKEN")
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Python

import os, requests

url = "https://api.verifik.co/v2/check-lists"
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {os.getenv('VERIFIK_TOKEN')}"
}
params = {"page": 1, "perPage": 20, "search": "Colombia"}
r = requests.get(url, params=params, headers=headers)
print(r.json())

Go

package main

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

func main() {
    req, _ := http.NewRequest("GET", "https://api.verifik.co/v2/check-lists?page=1&perPage=20&search=Colombia", 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 with page

{
    "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"
        }
    ],
    "total": 1,
    "limit": 20,
    "page": 1,
    "pages": 1
}

200 without page

{
    "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"
}

Notes

• リストは JWT 上のクライアントに属します。他のクライアントのリストは読めません。
• 並び順は常に新しい updatedAt が先です。
• search と text は同じ大文字小文字を区別しない名前一致です。
• perPage と limit はエイリアスです。page なしで limit を送っても、配列は上限されます。
• このエンドポイントはクレジットを消費せず、保存したサービスも実行しません。
• 製品の手順: Check List。作成: チェックリストを作成。