Skip to main content
POST
/
v1
/
lists
/
{uuid}
/
entries
Create List Entry
curl --request POST \
  --url https://identity.contra.id/v1/lists/{uuid}/entries
curl -X POST https://identity.contra.id/v1/lists/$UUID/entries \
  -H "x-api-key: $CONTRA_KEY" -H "Content-Type: application/json" \
  -d '{
    "entry_type":   "document",
    "value":        "PASSPORT:GB:AB123456",
    "reason":       "fraud · chargeback",
    "session_id":   "sess_b3f1c2a4"
  }'
BodyTypeRequiredDescription
entry_typeenumyesdocument · phone · email · face.
valuestringconditionalRequired for non-face entries.
imagebase64conditionalRequired when entry_type=face (see Upload Face).
session_idstringrecommendedLink back to the source session for audit.
reasonstringnoAudited.

​
Response · 201

{
  "uuid":       "ent_a1b2…",
  "entry_type": "document",
  "list":       "lst_internal_block",
  "added_at":   1748566800
}