> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # リスト作成API：許可リストとカスタムリスト > POST /v3/lists/ でDiditアプリケーションに新しい許可リストまたはカスタムリストを作成します。システムのブロックリストは自動で用意されます。呼び出しごとの従量課金で契約不要。 リスト作成APIのプロンプト プロンプトをクリップボードにコピー \

\`Create a new allowlist or custom list in my Didit application through the Management API.

Endpoint:
POST https://verification.didit.me/v3/lists/

Authentication:
Use the x-api-key header with my Didit API key. A scoped API key needs workflows: write.

Goal:
\- Create an allowlist (matching items are treated as trusted, for example to skip a duplicated-face or duplicated-IP action; it never overrides a blocklist match) or a custom list (for workflow conditions, transaction rules, or manual review).
\- System blocklists are provisioned by Didit, one per entry type. You cannot create a blocklist.

Request body (application/json):
\{
"name": "Trusted office IPs",          // required, at most 255 characters, unique among the application's lists
"description": "Office egress ranges", // optional
"list_type": "allowlist",              // required: "allowlist" or "custom"
"entry_type": "ip_address"             // required: face | document | phone | email | ip_address | device_fingerprint | wallet_address | bank_account | country | user | business | key
}

entry_type is fixed once the list exists: it decides how entry values are validated and matched.

Example call:
curl -X POST "https://verification.didit.me/v3/lists/" \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name": "Trusted office IPs", "list_type": "allowlist", "entry_type": "ip_address"}'

Example response (201):
\{
"uuid": "66666666-7777-8888-9999-000000000000",
"name": "Trusted office IPs",
"description": "",
"list_type": "allowlist",
"entry_type": "ip_address",
"is_system": false,
"entry_count": 0,
"last_entry_added_at": null,
"created_at": "2026-10-12T09:15:44.031876Z",
"updated_at": "2026-10-12T09:15:44.031876Z"
}

Persist the returned uuid: use it as list_uuid in the entry calls, and as the value of a workflow or transaction rule condition with value_type "list".

Failure modes:
\- 400: list_type is "blocklist", a required field is missing, name is longer than 255 characters, entry_type is unknown, or another list of the application already has this name ({ "name": ["A list with this name already exists for this application."] }).
\- 401: the API key has expired.
\- 403: missing x-api-key (a wrong, revoked or expired key gets 401) ({ "detail": "You do not have permission to perform this action." }), or a scoped key without workflows: write.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- Creates a new list in the application the API key belongs to.

For the full integration shape, see /integration/integration-prompt.`

\
貼り付け先 アプリケーション用のリストを作成します。作成できるのは`allowlist`と`custom`のリストのみです。Diditはエントリータイプごとにシステムのブロックリストを1つ用意しており、そこへの追加は[エントリーの作成](https://docs.didit.me/ja/management-api/lists/create-entry.md)で行います。`entry_type`は慎重に選んでください。後から変更することはできず、追加する各値がどのように検証されるかを決定します。各リストタイプの役割については[リスト](https://docs.didit.me/ja/management-api/lists/overview.md)を参照してください。 ## OpenAPI ````yaml ja/openapi-25.json POST /v3/lists/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: 本人確認API。x-api-keyヘッダーで認証します。 servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/: post: tags: - Lists summary: リストを作成 description: >- APIキーが属するアプリケーションに、許可リストまたはカスタムリストを作成します。ブロックリストは作成できません。Diditはエントリータイプごとにシステムブロックリストを1つ用意しており、[リストエントリーを作成](https://docs.didit.me/ja/management-api/lists/create-entry)でそこに追加します。`entry_type`は作成後に変更できず、エントリー値の検証方法と照合方法を決定します。許可リストのエントリーは一致した項目を信頼済みとしてマークします（たとえば、顔の許可リストでは重複顔のアクションがスキップされます）が、ブロックリストとの一致を上書きすることはありません。どのリストも`value_type: "list"`を使ってワークフローまたは取引ルールの条件から参照できます。スコープ付きAPIキーには`workflows: write`が必要です。 operationId: create_list requestBody: required: true content: application/json: schema: type: object required: - name - list_type - entry_type properties: name: type: string minLength: 1 maxLength: 255 description: リスト名です。システムリストを含め、アプリケーションの他のすべてのリストの名前と異なる必要があります。 description: type: string default: '' description: 任意の自由記述の説明です。 list_type: type: string enum: - allowlist - custom description: '`allowlist`または`custom`。`blocklist`は`400`で拒否されます。' entry_type: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key description: >- リストが保持する内容です。`face`、`document`（書類番号）、`phone`、`email`、`ip_address`（IPアドレスまたはCIDR範囲）、`device_fingerprint`、`wallet_address`、`bank_account`、`country`（ISO 3166-1 alpha-3）、`user`または`business`（お客様の`vendor_data`）、`key`（任意の文字列）のいずれかです。エントリの値の検証方法と照合方法はこれによって決まります。後から変更することはできません。 examples: IP allowlist: value: name: Trusted office IPs description: Office egress ranges list_type: allowlist entry_type: ip_address Custom country list: value: name: Enhanced due diligence countries list_type: custom entry_type: country responses: '201': description: リストが作成されました。 content: application/json: schema: $ref: '#/components/schemas/ComplianceList' examples: New allowlist: value: uuid: 22222222-3333-4444-5555-666666666666 name: Trusted office IPs description: Office egress ranges list_type: allowlist entry_type: ip_address is_system: false entry_count: 0 last_entry_added_at: null created_at: '2026-10-12T09:15:44.031876Z' updated_at: '2026-10-12T09:15:44.031876Z' '400': description: ボディが無効です。 content: application/json: examples: Blocklist refused: value: list_type: - >- Cannot create additional blocklist lists. System blocklists are auto-created for each application. Duplicate name: value: name: - >- A list with this name already exists for this application. Missing fields: value: name: - This field is required. list_type: - This field is required. entry_type: - This field is required. Unknown entry type: value: entry_type: - '"iban" is not a valid choice.' Name too long: value: name: - Ensure this field has no more than 255 characters. '401': description: スコープ付きAPIキーの有効期限が切れています。その他の認証エラーでは`403`が返されます。 content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- `x-api-key`ヘッダーがありません（誤った、失効した、または期限切れのキーには`401`が返されます）。または、スコープ付きAPIキーに`workflows: write`がないか、許可リスト外のIPアドレスから使用されています。 content: application/json: examples: Missing or invalid API key: value: detail: You do not have permission to perform this action. Scoped key without workflows access: value: detail: This API key has no write access to workflows. '429': $ref: '#/components/responses/RateLimitedWrite' security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: |- curl -X POST 'https://verification.didit.me/v3/lists/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{ "name": "Trusted office IPs", "description": "Office egress ranges", "list_type": "allowlist", "entry_type": "ip_address" }' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.lists.create( name="Trusted office IPs", description="Office egress ranges", list_type="allowlist", entry_type="ip_address", ) print(result) - lang: javascript label: Node.js source: |- import Didit from "@didit-protocol/sdk-node"; // Reads DIDIT_API_KEY. const didit = new Didit(); const result = await didit.lists.create({ name: "Trusted office IPs", description: "Office egress ranges", list_type: "allowlist", entry_type: "ip_address", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Lists.Create(ctx, didit.ListsCreateParams{\n\tName: \"Trusted office IPs\",\n\tDescription: didit.String(\"Office egress ranges\"),\n\tListType: \"allowlist\",\n\tEntryType: \"ip_address\",\n})\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Printf(\"%+v\\n\", result)" - lang: java label: Java source: |- import me.didit.Didit; import me.didit.types.ListsCreateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.lists().create(ListsCreateParams.builder() .name("Trusted office IPs") .description("Office egress ranges") .listType(ListsCreateParams.ListType.of("allowlist")) .entryType(ListsCreateParams.EntryType.of("ip_address")) .build()); System.out.println(result); - lang: php label: PHP source: |- lists->create([ 'name' => 'Trusted office IPs', 'description' => 'Office egress ranges', 'list_type' => 'allowlist', 'entry_type' => 'ip_address', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.lists.create( name: "Trusted office IPs", description: "Office egress ranges", list_type: "allowlist", entry_type: "ip_address" ) puts result.to_h - lang: csharp label: .NET source: |- using System; using System.Text.Json; using Didit; // Reads DIDIT_API_KEY. using var client = new DiditClient(); var result = await client.Lists.CreateAsync(new ListsCreateParams { Name = "Trusted office IPs", Description = "Office egress ranges", ListType = "allowlist", EntryType = "ip_address", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: ComplianceList: type: object description: 1つのアプリケーションのブロックリスト、許可リスト、またはカスタムリスト。 required: - uuid - name - description - list_type - entry_type - is_system - entry_count - last_entry_added_at - created_at - updated_at properties: uuid: type: string format: uuid description: >- リストの識別子です。リストおよびエントリのエンドポイントでは`list_uuid`として使用し、`value_type: "list"`のワークフローまたは取引ルールの条件では値として使用します。 name: type: string maxLength: 255 description: リスト名です。アプリケーションのリスト内で一意です。 description: type: string description: 自由記述の説明。未設定の場合は空文字列です。 list_type: type: string enum: - blocklist - allowlist - custom description: >- `blocklist`：一致するとセッションまたは取引が却下されます（システムリストのみ、エントリタイプごとに1つ）。`allowlist`：一致した項目は信頼されます。たとえば顔の許可リストでは重複顔のアクションがスキップされます。ブロックリストの一致を上書きすることはありません。`custom`：ワークフローおよび取引ルールの条件で使用されます（`value_type: "list"`）。 entry_type: type: string enum: - face - document - phone - email - ip_address - device_fingerprint - wallet_address - bank_account - country - user - business - key description: >- リストが保持する内容です。`face`、`document`（書類番号）、`phone`、`email`、`ip_address`（IPアドレスまたはCIDR範囲）、`device_fingerprint`、`wallet_address`、`bank_account`、`country`（ISO 3166-1 alpha-3）、`user`または`business`（お客様の`vendor_data`）、`key`（任意の文字列）のいずれかです。エントリの値の検証方法と照合方法はこれによって決まります。 is_system: type: boolean description: >- Diditが用意するリストでは`true`です。対象は、エントリタイプごとに1つずつ用意されるブロックリスト（`face`、`document`、`phone`、`email`、`ip_address`、`device_fingerprint`、`wallet_address`、`bank_account`、`user`、`business`）、**High Risk Countries**カスタムリスト、およびシステム許可リストです。システムリストは名前の変更、編集、削除ができません。エントリの追加と削除は可能です。 entry_count: type: integer minimum: 0 description: 現在リストに含まれるエントリー数。 last_entry_added_at: type: string format: date-time nullable: true description: 最新の現行エントリが追加された日時。空のリストでは`null`です。 created_at: type: string format: date-time description: リストが作成された日時。 updated_at: type: string format: date-time description: リストが最後に更新された日時。 responses: RateLimitedWrite: description: APIキーあたり毎分300リクエストの共有書き込み制限を超えました。再試行する前に`Retry-After`に従ってください。 content: application/json: schema: type: object required: - detail properties: detail: type: string example: detail: >- Write request rate limit exceeded. You can make up to 300 requests per minute. securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権（なし、読み取り、書き込み）、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.