> ## 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. # Crear entrada a llista de bloqueig i permesos: API > Afegeix una entrada (cara, document, IP, cartera, correu o telèfon) a una llista de bloqueig o permesos de Didit. Controls de frau via API. Prompt d'API per crear una entrada de llista Copia el prompt al porta-retalls \

\`Add an entry to a Didit list (blocklist, allowlist, or custom) through the Management API.

Endpoint:
POST https://verification.didit.me/v3/lists/{list_uuid}/entries/

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

Goal:
\- Insert a single entry into a list. Three add modes are supported:
1\. By value: pass value matching the list's entry_type.
2\. From a verification session: pass reference_session_id and Didit reads the value from the session's most recent record of the list's entry_type (face, document, phone, email, ip_address, device_fingerprint) and links the entry to the session.
3\. With a source reference: pass value plus reference_object_uuid and metadata.reference_type so the console links the entry back to the transaction, user or business it came from.

Path parameter:
\- list_uuid: list UUID from GET /v3/lists/. For a face without a session, use POST /v3/lists/{list_uuid}/entries/face-upload/ instead.

Request body (application/json):
\{
"value": "string",                  // required unless reference_session_id is sent
"reference_session_id": "uuid",     // optional: read the value from this session of my application
"reference_object_uuid": "uuid",    // optional: transaction UUID, or didit_internal_id of a user or business
"face_image_source": "liveness" | "front_image_camera_front" | "back_image_camera_front", // optional, system face blocklist + reference_session_id only; default liveness
"reference_node_id": "string",      // optional, with a document-capture face_image_source: which ID verification node's selfie to use
"display_label": "string",          // optional, at most 512 characters
"comment": "string",                // optional, reason or note
"metadata": {                       // optional, free-form; reference_image_url and front_image_url are ignored
"reference_type": "transaction" | "vendor_user" | "vendor_business",
"reference_id": "uuid"
}
}

Value validation by entry_type:
\- email: valid email address.
\- phone: valid international phone number (stored in E.164).
\- ip_address: IP address or CIDR range (e.g. 10.0.0.0/8).
\- device_fingerprint: at least 8 characters among letters, digits, -, _, : and . (a blocklist refuses a fingerprint that several distinct devices have reported).
\- country: ISO 3166-1 alpha-2 or alpha-3 (stored as alpha-3).
\- user, business: the vendor_data to block.
\- face, document, wallet_address, bank_account, key: any non-empty string.
Values are case-insensitive: country codes are stored in upper case, phone numbers in E.164, everything else in lower case.
A list holds each value once: adding a value that is already there returns 400.

Adding from a session, what Didit does:
\- Looks up the session (it must belong to the same application).
\- Reads the value from the session's most recent record of the list's entry_type:
\- face: the liveness face (value is the face UUID). With face_image_source = front_image_camera_front / back_image_camera_front, the face from the selfie the front camera took while the user photographed the front / back of their document instead (system face blocklist only, leave value empty).
\- document: the document number; full_name, issuing_state, document_type, region and document_number go into metadata.
\- phone / email: the phone number / email address.
\- ip_address: the session's IP address.
\- device_fingerprint: a fingerprint that identifies one device. On a blocklist, Didit refuses a session that only has a device-class fingerprint or was completed on more than one device; pass the exact fingerprint as value in that case.
\- Links the entry to the session (reference_session_id) and to that record (reference_object_uuid).
\- If I also send value, Didit stores my value but still links the most recent record. To list a value from an earlier record, add it by value without reference_session_id.

Example calls:
\# By value
curl -X POST "https://verification.didit.me/v3/lists/{list_uuid}/entries/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"value": "+14155552671", "comment": "Reported fraud"}'

\# From a session
curl -X POST "https://verification.didit.me/v3/lists/{list_uuid}/entries/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"reference_session_id": "33333333-4444-5555-6666-777777777777"}'

\# The face from the selfie taken during document capture (system face blocklist)
curl -X POST "https://verification.didit.me/v3/lists/{list_uuid}/entries/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"reference_session_id": "33333333-4444-5555-6666-777777777777", "face_image_source": "front_image_camera_front"}'

\# From a transaction
curl -X POST "https://verification.didit.me/v3/lists/{list_uuid}/entries/" \
-H "x-api-key: YOUR_API_KEY" -H "Content-Type: application/json" \
-d '{"value": "0x52908400098527886E0F7030069857D2E4169EE7", "reference_object_uuid": "55555555-6666-7777-8888-999999999999", "metadata": {"reference_type": "transaction"}}'

Failure modes:
\- 400: value fails the entry_type validator or is already in the list, neither value nor reference_session_id was sent, reference_session_id is not a session of this application, or the session has no data of the list's entry_type.
\- 400 (face_image_source): the list is not the system face blocklist, value was sent, the session has no image for that source, no clear face was found in that selfie, or that selfie is already in the blocklist.
\- 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.
\- 404: list not found in this application ({ "detail": "List not found." }).
\- 503 (face_image_source): face analysis is temporarily unavailable; nothing was added, retry later.
\- 429: rate limited (see /integration/rate-limiting); back off and retry.

Side effects:
\- System face, document, phone and email blocklists: a record read from a session is flagged as blocklisted at once, and new sessions that match it are declined.
\- System user and business blocklists: users or businesses of the application whose vendor_data equals value (or whose UUID equals reference_object_uuid) are set to BLOCKED.
\- Sessions and transactions that already finished are not changed.

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

\
Enganxa a Afegeix una entrada a una llista. El valor es valida segons el tipus d'entrada de la llista:* **email**: una adreça de correu electrònic vàlida * **phone**: un número de telèfon internacional vàlid, desat en E.164 (per exemple `+14155552671`) * **ip\_address**: una adreça IP vàlida o un rang CIDR (p. ex. `192.168.1.1` o `10.0.0.0/8`) * **device\_fingerprint**: com a mínim 8 caràcters entre lletres, dígits, `-`, `_`, `:` i `.`. Una llista de bloqueig rebutja una empremta que diversos dispositius diferents han reportat, perquè bloquejar-la rebutjaria persones no relacionades. * **country**: un [codi de país ISO 3166-1 alpha-3](https://docs.didit.me/ca/core-technology/id-verification/supported-documents-id-verification.md) vàlid (p. ex. `USA`, `GBR`, `ESP`). Els codis alpha-2 (p. ex. `US`) s'accepten i es converteixen automàticament a alpha-3. * **user**, **business**: el `vendor_data` de l'usuari o de l'empresa * **face**, **document**, **wallet\_address**, **bank\_account**, **key**: qualsevol cadena no buida> [!NOTE] > > Tots els valors de les entrades són **insensibles a majúscules i minúscules**: els valors que envies es normalitzen en desar-los (els números de telèfon a E.164, els codis de país a majúscules i la resta a minúscules) i es comparen sense distingir majúscules durant la verificació. Per exemple, bloquejar `User@Example.COM` també detectarà `user@example.com`. Una llista conté cada valor una sola vegada: afegir un valor que ja hi és retorna `400`.Per a una cara, usa [Pujar cara](https://docs.didit.me/ca/management-api/lists/upload-face.md) quan només tinguis una imatge, o envia un `reference_session_id` per prendre la cara d'una sessió existent. Una entrada de cara necessita una cara desada amb la qual comparar, cosa que un `value` escrit no proporciona.## Afegir des d'una sessióQuan proporciones un `reference_session_id`, Didit:1) Cerca la sessió (ha de pertànyer a la mateixa aplicació) 2) Llegeix el valor del registre **més recent** de la sessió del tipus d'entrada de la llista: * **face**: la cara de la selfie de prova de vida; `value` és l'UUID de la cara * **document**: el número del document; el nom complet, l'estat emissor, el tipus de document, la regió i el número del document es desen a `metadata`, i `display_label` agafa per defecte el nom del titular i el número del document * **phone**: el número de telèfon * **email**: l'adreça de correu electrònic * **ip\_address**: l'adreça IP de la sessió * **device\_fingerprint**: una empremta que identifica un dispositiu, preferint un dispositiu que hagi completat un pas de verificació. En una llista de bloqueig, Didit rebutja una sessió que només té una empremta de classe de dispositiu, o una completada en més d'un dispositiu: en aquest cas, envia l'empremta exacta com a `value`. 3) Enllaça l'entrada a la sessió (`reference_session_id`) i al registre (`reference_object_uuid`) per a la traçabilitatA les llistes de bloqueig del sistema de cares, documents, telèfons i correus, el registre també es marca com a inclòs a la llista de bloqueig, de manera que les noves sessions que hi coincideixin es rebutgen. Per a qualsevol altre tipus d'entrada, envia també `value`.Retorna `400` si no es troba la sessió o si no conté dades del tipus d'entrada sol·licitat.### Cares de la selfie de captura del documentMentre l'usuari fotografia el seu document, la càmera frontal pot fer-li una selfie (les imatges `front_image_camera_front` i `back_image_camera_front` de l'[informe de verificació d'identitat](https://docs.didit.me/ca/core-technology/id-verification/report-id-verification.md)). Aquesta cara es pot afegir a la llista de bloqueig de cares, igual que la cara de la selfie de la prova de vida: passa `face_image_source` amb la imatge que vulguis.```json theme={null} { "reference_session_id": "33333333-4444-5555-6666-777777777777", "face_image_source": "front_image_camera_front" } ```- L'entrada només es crea a la **llista de bloqueig de cares** del sistema, i `value` ha de quedar buit: Didit pren la cara de la selfie de la sessió. - La selfie ha de contenir una sola cara nítida. Si no és així, la sol·licitud retorna `400` i no s'afegeix res. - Cada selfie es pot afegir una sola vegada. `metadata.face_image_source` i `metadata.reference_node_id` indiquen de quina selfie procedeix l'entrada. - En un flux de treball amb més d'un pas de verificació d'identitat, `reference_node_id` tria el pas la selfie del qual s'ha d'usar. Per defecte, Didit usa la verificació d'identitat més recent que tingui aquesta selfie. - A partir d'aleshores, la cara es comprova com qualsevol altra cara bloquejada: amb la selfie de prova de vida de cada nova sessió i amb cada nova selfie de captura del document (vegeu [`FRONT_CAMERA_FACE_IN_BLOCKLIST`](https://docs.didit.me/ca/core-technology/id-verification/warnings-id-verification)). - Eliminar l'entrada suprimeix la cara de la llista de bloqueig, i deixa de coincidir amb les noves sessions.### Sessions amb diversos registres del mateix tipusUna sessió pot tenir més d'un registre d'un tipus, per exemple dos números de telèfon en un flux de treball de diversos passos. Didit sempre llegeix el registre **més recent**. Si envies `value` juntament amb `reference_session_id`, l'entrada desa el teu `value` però continua enllaçada a aquest registre més recent, i en una llista de bloqueig del sistema és aquest registre el que es marca.Per afegir un valor d'un registre anterior, afegeix-lo només amb `value`, sense `reference_session_id`:```json theme={null} { "value": "+34612345678", "comment": "First phone number of session 42" } ```## Referenciar transaccions, usuaris i empresesQuan bloquegis dades d'una transacció o d'un usuari o empresa de proveïdor, passa l'UUID de l'entitat com a `reference_object_uuid` i indica el tipus d'origen a `metadata`:```json theme={null} { "value": "0x52908400098527886E0F7030069857D2E4169EE7", "reference_object_uuid": "55555555-6666-7777-8888-999999999999", "metadata": { "reference_type": "transaction", "reference_id": "55555555-6666-7777-8888-999999999999" } } ```Això et permet anar de l'entrada de la llista a la transacció, l'usuari o l'empresa original a la consola. Didit desa les claus de `metadata` que enviïs, excepte `reference_image_url` i `front_image_url`, que només Didit estableix. Per a una entrada llegida d'una sessió, Didit afegeix les seves pròpies claus a les teves, i les seves claus prevalen.| Entitat d'origen | `reference_object_uuid` | `metadata.reference_type` | | - | - | - | | Sessió de verificació | La defineix Didit (el registre de la cara, el document, el telèfon o el correu) | No cal: usa `reference_session_id` | | Transacció | UUID de la transacció | `"transaction"` | | Usuari de proveïdor | `didit_internal_id` | `"vendor_user"` | | Empresa de proveïdor | `didit_internal_id` | `"vendor_business"` |A les llistes de bloqueig del sistema **Usuari** i **Empresa**, Didit també posa com a `BLOCKED` els usuaris o les empreses corresponents: aquells el `vendor_data` dels quals és igual a `value`, o aquells el `didit_internal_id` dels quals és igual a `reference_object_uuid`. Consulta [Llista de bloqueig d'usuaris](https://docs.didit.me/ca/entities/users/blocklist.md) i [Llista de bloqueig d'empreses](https://docs.didit.me/ca/entities/businesses/blocklist.md). ## OpenAPI ````yaml ca/openapi-25.json POST /v3/lists/{list_uuid}/entries/ openapi: 3.0.0 info: version: 3.0.0 title: Didit Verification API description: API de verificació d'identitat. Autentica't amb la capçalera x-api-key. servers: - url: https://verification.didit.me security: [] tags: [] paths: /v3/lists/{list_uuid}/entries/: post: tags: - Lists summary: Crea una entrada de llista description: >- Afegeix una entrada a una llista, d'una de tres maneres: per `value`; des d'una sessió de verificació amb `reference_session_id`, on Didit llegeix el valor del registre més recent de la sessió del tipus d'entrada de la llista i hi enllaça l'entrada; o per `value` amb un `reference_object_uuid` i `metadata.reference_type` que apunten a una transacció, usuari o empresa. A les llistes de bloqueig del sistema de cares, documents, telèfons i correus electrònics, el registre llegit de la sessió també es marca com a bloquejat a la llista de bloqueig, de manera que les noves sessions coincidents es rebutgen; a les llistes de bloqueig del sistema d'usuaris i empreses, els usuaris o empreses coincidents s'estableixen a `BLOCKED`. Les sessions i transaccions que ja han finalitzat no es modifiquen. Una clau d'API amb abast necessita `workflows: write`. Consulta [Crea una entrada de llista](https://docs.didit.me/ca/management-api/lists/create-entry) per a cada mode. operationId: create_list_entry parameters: - name: list_uuid in: path required: true description: >- UUID de la llista a la qual cal afegir. Per a una cara que només tinguis com a imatge, fes servir Pujar una cara a una llista. schema: type: string format: uuid example: 11111111-2222-3333-4444-555555555555 requestBody: required: true content: application/json: schema: type: object description: >- Envia `value`, `reference_session_id`, o tots dos. Els camps aplicables depenen del valor de `entry_type` de la llista. properties: value: type: string description: >- El valor que s'ha d'incloure a la llista, validat contra l'`entry_type` de la llista: `email` una adreça de correu electrònic vàlida; `phone` un número internacional vàlid, emmagatzemat en E.164; `ip_address` una adreça IP o rang CIDR (per exemple `10.0.0.0/8`); `device_fingerprint` almenys 8 caràcters entre lletres, dígits, `-`, `_`, `:` i `.` (una llista de bloqueig rebutja una empremta que diversos dispositius diferents hagin reportat); `country` un codi ISO 3166-1 alpha-2 o alpha-3, emmagatzemat com a alpha-3; `user` i `business` el `vendor_data`; qualsevol altre tipus una cadena no buida. S'emmagatzema en minúscules excepte els números de telèfon i els codis de país, i una llista conté cada valor una sola vegada (sense distingir majúscules de minúscules). Obligatori tret que s'enviï `reference_session_id`; s'ha de deixar buit amb un `face_image_source` de captura de documents. reference_session_id: type: string format: uuid description: >- Una sessió de verificació de persona o empresa de la teva aplicació d'on extreure el valor. Didit llegeix el registre més recent de la sessió del tipus d'entrada de la llista (`face`, `document`, `phone`, `email`, `ip_address` o `device_fingerprint`), enllaça l'entrada a la sessió i a aquest registre, i emplena `display_label` i `metadata` per als documents. Per a una llista de bloqueig de `device_fingerprint`, es rebutja una sessió que només té una empremta digital de classe de dispositiu o que s'ha completat en més d'un dispositiu: envia l'empremta digital exacta com a `value`. Per a altres tipus d'entrada, o quan la sessió no té cap registre d'aquest tipus, envia també `value`; el teu `value` s'emmagatzema i l'entrada continua enllaçada a la sessió. reference_object_uuid: type: string format: uuid description: >- UUID del registre que representa l'entrada quan no prové d'una sessió: un UUID de transacció, o el `didit_internal_id` d'un usuari o empresa. Emparella'l amb `metadata.reference_type`. Se substitueix pel registre de la sessió quan `reference_session_id` en proporciona un. face_image_source: type: string enum: - liveness - front_image_camera_front - back_image_camera_front default: liveness description: >- Llistes facials amb `reference_session_id`: de quina de les imatges de la sessió s'extreu la cara. `liveness` (per defecte) és la selfie de prova de vida. `front_image_camera_front` i `back_image_camera_front` són les selfies que la càmera frontal va fer mentre l'usuari fotografiava l'anvers o el revers del seu document: acceptades només a la llista de bloqueig facial del sistema, amb `reference_session_id` i un `value` buit. Cada selfie es pot afegir un cop i ha de mostrar una única cara clara. reference_node_id: type: string nullable: true maxLength: 100 description: >- Amb un `face_image_source` de captura de documents: el node de verificació d'identitat la selfie del qual s'ha d'utilitzar, per a fluxos de treball amb més d'un node. Per defecte, la verificació d'identitat més recent que conté aquesta imatge. Es rebutja amb `liveness`. display_label: type: string maxLength: 512 description: >- Etiqueta fàcil de llegir. Quan està buida, Didit en dedueix una a partir de la sessió quan és possible (per exemple, el nom del titular i el número de document). comment: type: string description: >- Nota de text lliure, com ara el motiu de la inclusió a la llista. metadata: type: object additionalProperties: true description: >- JSON de format lliure emmagatzemat amb l'entrada i retornat tal com s'ha desat. Fes servir `reference_type` i `reference_id` perquè el tauler enllaci amb l'origen. `reference_image_url` i `front_image_url` només els estableix Didit i s'ometen si els envies. Per a una entrada llegida des d'una sessió, les claus de Didit es fusionen amb les teves. properties: reference_type: type: string enum: - transaction - vendor_user - vendor_business description: A què apunta `reference_object_uuid`. reference_id: type: string description: Identificador del registre d'origen. examples: By value: value: value: '+14155552671' comment: Reported fraud From a session: value: reference_session_id: 33333333-4444-5555-6666-777777777777 Face from a document-capture selfie: value: reference_session_id: 33333333-4444-5555-6666-777777777777 face_image_source: front_image_camera_front From a transaction: value: value: '0x52908400098527886E0F7030069857D2E4169EE7' reference_object_uuid: 55555555-6666-7777-8888-999999999999 comment: Linked to a chargeback metadata: reference_type: transaction reference_id: 55555555-6666-7777-8888-999999999999 Country: value: value: PRK comment: Sanctioned jurisdiction responses: '201': description: S'ha creat l'entrada. content: application/json: schema: $ref: '#/components/schemas/ComplianceListEntry' examples: By value: value: uuid: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee value: '+14155552671' display_label: '' comment: Reported fraud added_by: api reference_session_id: null reference_session_number: null reference_session_type: null reference_object_uuid: null metadata: null created_at: '2026-10-12T10:04:51.220391Z' Document from a session: value: uuid: bbbbbbbb-cccc-dddd-eeee-ffffffffffff value: X1234567 display_label: Jane Doe - X1234567 comment: '' added_by: api reference_session_id: 33333333-4444-5555-6666-777777777777 reference_session_number: 1042 reference_session_type: kyc reference_object_uuid: 66666666-7777-8888-9999-000000000000 metadata: full_name: Jane Doe issuing_state: ESP document_type: ID region: '' document_number: X1234567 created_at: '2026-10-12T10:06:12.774915Z' From a transaction: value: uuid: dddddddd-eeee-ffff-0000-111111111111 value: '0x52908400098527886e0f7030069857d2e4169ee7' display_label: '' comment: Linked to a chargeback added_by: api reference_session_id: null reference_session_number: null reference_session_type: null reference_object_uuid: 55555555-6666-7777-8888-999999999999 metadata: reference_type: transaction reference_id: 55555555-6666-7777-8888-999999999999 created_at: '2026-10-12T10:20:40.117062Z' '400': description: >- El cos no és vàlid, el valor ja és a la llista o la sessió no pot proporcionar el valor. content: application/json: examples: Nothing to list: value: value: - >- Either 'value' or 'reference_session_id' must be provided. Duplicate value: value: value: - An entry with this value already exists in this list. Invalid phone: value: value: - >- Invalid phone number. Provide a valid international number (e.g. +1234567890). Invalid IP: value: value: - >- Invalid IP address or CIDR range (e.g. 192.168.1.1 or 10.0.0.0/24). Invalid country: value: value: - >- Invalid country code: XX. Provide a valid ISO 3166-1 alpha-2 or alpha-3 country code. Device-class fingerprint: value: value: - >- This value is a device-class fingerprint: several distinct devices have reported it, so blocklisting it would decline unrelated people. Block the user by document, face, email or phone instead. Unknown session: value: reference_session_id: - >- Session not found or does not belong to this application. No data in session: value: value: - >- Either provide a 'value' or ensure the session contains data for this entry type. Selfie on another list: value: face_image_source: - >- A document-capture selfie can only be added to the face blocklist. No clear face in selfie: value: face_image_source: - >- No clear face was found in this selfie, so it cannot be blocklisted. Selfie already listed: value: face_image_source: - This selfie is already in the blocklist. '401': description: >- La clau d'API amb abast ha caducat. Altres fallades d'autenticació retornen `403`. content: application/json: examples: Expired API key: value: detail: This API key has expired. '403': description: >- Falta la capçalera `x-api-key` (una clau incorrecta, revocada o caducada rep un `401`), o una clau d'API amb àmbit no té `workflows: write` o s'utilitza des d'una adreça IP fora de la seva llista d'admesos. 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. '404': description: >- No existeix cap llista amb aquest UUID a l'aplicació de la clau d'API, o s'ha suprimit. content: application/json: examples: Not found: value: detail: List not found. '429': $ref: '#/components/responses/RateLimitedWrite' '503': description: >- L'anàlisi facial d'una selfie de captura de documents no està disponible temporalment. No s'ha afegit res; torna-ho a provar més tard. content: application/json: examples: Unavailable: value: detail: Service temporarily unavailable. Please try again later. security: - ApiKeyAuth: [] x-codeSamples: - lang: curl label: curl source: >- curl -X POST 'https://verification.didit.me/v3/lists/11111111-2222-3333-4444-555555555555/entries/' \ -H 'x-api-key: YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"value": "+14155552671", "comment": "Reported fraud"}' - lang: python label: Python source: |- from didit import Didit # Reads DIDIT_API_KEY. client = Didit() result = client.lists.entries.create( "11111111-2222-3333-4444-555555555555", value="+14155552671", comment="Reported fraud", ) 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.entries.create("11111111-2222-3333-4444-555555555555", { value: "+14155552671", comment: "Reported fraud", }); console.log(result); - lang: go label: Go source: "ctx := context.Background()\n// Reads DIDIT_API_KEY.\nclient := didit.NewClient()\n\nresult, err := client.Lists.Entries.Create(ctx, \"11111111-2222-3333-4444-555555555555\", didit.ListsEntriesCreateParams{\n\tValue: didit.String(\"+14155552671\"),\n\tComment: didit.String(\"Reported fraud\"),\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.ListsEntriesCreateParams; // Reads DIDIT_API_KEY. Didit client = new Didit(); var result = client.lists().entries().create("11111111-2222-3333-4444-555555555555", ListsEntriesCreateParams.builder() .value("+14155552671") .comment("Reported fraud") .build()); System.out.println(result); - lang: php label: PHP source: >- lists->entries->create('11111111-2222-3333-4444-555555555555', [ 'value' => '+14155552671', 'comment' => 'Reported fraud', ]); print_r($result->toArray()); - lang: ruby label: Ruby source: |- require "didit" # Reads DIDIT_API_KEY. didit = Didit::Client.new result = didit.lists.entries.create( "11111111-2222-3333-4444-555555555555", value: "+14155552671", comment: "Reported fraud" ) 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.Entries.CreateAsync("11111111-2222-3333-4444-555555555555", new ListsEntriesCreateParams { Value = "+14155552671", Comment = "Reported fraud", }); Console.WriteLine(JsonSerializer.Serialize(result)); components: schemas: ComplianceListEntry: type: object description: Un valor en una llista. required: - uuid - value - display_label - comment - added_by - reference_session_id - reference_session_number - reference_session_type - reference_object_uuid - metadata - created_at properties: uuid: type: string format: uuid description: >- Identificador de l'entrada. Utilitza'l com a `entry_uuid` a l'operació «Eliminar una entrada de llista». value: type: string description: >- El valor llistat: un número de telèfon en E.164, una adreça de correu electrònic, un número de document, una adreça IP o rang CIDR, una empremta digital de dispositiu, una adreça de cartera, un compte bancari, un codi de país ISO 3166-1 alfa-3, un `vendor_data`, qualsevol cadena en una llista `key`, o l'UUID de la cara emmagatzemada en una llista de cares. Els valors que envies s'emmagatzemen en minúscules, excepte els números de telèfon i els codis de país. La coincidència no distingeix entre majúscules i minúscules. display_label: type: string nullable: true maxLength: 512 description: >- Etiqueta fàcil de llegir. Didit l'emplena per a entrades extretes d'una sessió (per exemple, el nom del titular i el número de document) quan no n'envies cap. comment: type: string description: Nota de text lliure. Cadena buida si no s'ha definit. added_by: type: string nullable: true description: >- Qui ha afegit l'entrada: `api` (una clau d'API), l'adreça de correu electrònic d'un usuari de la consola o `console`, `system` o `migration` (entrades creades per Didit) o `rule` (una acció de regla de transacció o de monitoratge). reference_session_id: type: string format: uuid nullable: true description: >- Sessió de verificació d'on s'ha extret l'entrada. `null` quan l'entrada s'ha afegit per valor. reference_session_number: type: integer nullable: true description: >- Número d'aquesta sessió en l'àmbit de l'aplicació, tal com es mostra a la consola. reference_session_type: type: string nullable: true enum: - kyc - kyb - null description: >- `kyc` per a una sessió de verificació de persona, `kyb` per a una sessió de verificació d'empresa, `null` quan no hi ha cap sessió. reference_object_uuid: type: string format: uuid nullable: true description: >- El registre que representa l'entrada: el registre de rostre, document, telèfon o correu electrònic llegit d'una sessió, el rostre creat per Upload a face to a list, o l'UUID que has enviat (per exemple, un UUID de transacció o el `didit_internal_id` d'un usuari). metadata: type: object nullable: true additionalProperties: true description: >- Context addicional. Conté les claus que estableix Didit (llistades aquí) combinades amb qualsevol `metadata` que hagis enviat en crear l'entrada, retornades tal com s'han desat. `null` quan no n'hi ha cap. properties: reference_image_url: type: string description: >- Entrades facials: URL signada de curta durada, emesa de nou en cada crida; `null` per a una clau d'API amb un àmbit que no inclou `media: read`. Absent quan cap imatge pertany a l'entrada. front_image_url: type: string description: >- Entrades de document que contenen una imatge frontal del document: URL signat de curta durada, emès novament a cada crida; `null` per a una clau d'API amb abast limitat sense `media: read`. full_name: type: string description: >- Entrades de document obtingudes d'una sessió: nom complet del titular. issuing_state: type: string description: >- Entrades de document obtingudes d'una sessió: país emissor ISO 3166-1 alfa-3. document_type: type: string description: >- Entrades de document obtingudes d'una sessió: codi de tipus de document, per exemple `P`, `ID` o `DL`. region: type: string description: >- Entrades de document obtingudes d'una sessió: estat o província emissor d'un document emès regionalment, buit quan no correspongui. No s'estableix mitjançant Add session items to the blocklist. document_number: type: string description: >- Entrades de document obtingudes d'una sessió: el número de document. face_image_source: type: string enum: - front_image_camera_front - back_image_camera_front description: >- Entrades facials obtingudes d'una selfie de captura de documents: quina selfie. No apareix per a cares de prova de vida. reference_node_id: type: string nullable: true description: >- Entrades facials obtingudes d'una selfie de captura de documents: el node de verificació d'identitat d'on prové la selfie. fingerprint_tier: type: string nullable: true enum: - persistent_id - composite_hash - legacy_fp - unknown - null description: >- Entrades de la petjada digital del dispositiu obtingudes d'una sessió: com es va derivar la petjada digital. `persistent_id` identifica un sol dispositiu; `composite_hash` i `legacy_fp` es poden compartir entre dispositius del mateix model. sandbox: type: boolean description: >- `true` en una entrada facial pujada en una aplicació sandbox; aquesta entrada no coincideix amb res. reference_type: type: string enum: - transaction - vendor_user - vendor_business description: >- Definit per tu: a què apunta `reference_object_uuid`, perquè la consola hi enllaci de tornada. reference_id: type: string description: 'Definit per tu: identificador del registre d''origen.' created_at: type: string format: date-time description: Quan es va afegir l'entrada. responses: RateLimitedWrite: description: >- S'ha superat el límit compartit d'escriptura de 300 sol·licituds per minut per clau d'API. Respecta `Retry-After` abans de reintentar. 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: >- La clau d'API de la teva aplicació, des de Developers -> API keys a la Business Console. La clau primària té accés complet. Una clau amb nom pot tenir l'abast limitat: cap, lectura o escriptura per recurs, limitada a determinats fluxos de treball o a sessions aprovades, a una llista d'adreces IP i a una data de caducitat. 401 significa que la clau és incorrecta, revocada o caducada; 403 significa que no s'ha enviat cap clau, que la clau no té accés a aquest recurs o acció, o que la sol·licitud prové d'una adreça fora de la seva llista d'IP; 404 en una ruta de sessió significa que la sessió està fora dels fluxos de treball o estats de la clau. Una clau sense accés a fitxers multimèdia rep els URL d'imatge, vídeo i PDF com a null, i una clau sense permís d'escriptura de sessions rep els enllaços de sessió i els tokens com a null. Consulta https://docs.didit.me/console/api-keys. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.