---
title: "Add transactions to a list"
method: POST
path: "/api/knownfaces/lists/{listId}/transactions"
tags: ["KnownFaces"]
---

# Add transactions to a list

`POST /api/knownfaces/lists/{listId}/transactions`

## Request

- Base URL: `https://verification.trulioo.com`
- URL: `https://verification.trulioo.com/api/knownfaces/lists/{listId}/transactions`
- Auth: HTTP bearer

## Path parameters

- `listId` string, uuid, required

## Headers

- `Accept-Version` string, required

## Request body

- KnownFacesListAddTransactionRequest
  - `transactionIds` string[]: Transaction Ids to be added to the list (max 5000 transactions per list)

## Response `200`

OK

- KnownFacesListAddTransactionResponse
  - `failedTransactions` object[]
    - `transactionId` string
    - `cause` 'TRANSACTION_NOT_FOUND' | 'TRANSACTION_INVALID_ID' | 'UNKNOWN_ERROR'

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/trulioo/apis/kyc-document-api.md) - [All operations](https://skmtc.dev/trulioo/apis/kyc-document-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trulioo/apis/kyc-document-api/revisions/53a65736c9f8?raw)