Skip to content

Add Customer Requirement

Overview

Use the AddCustomerRequirement endpoint to add specific verification requirements for individual customers. This allows you to request additional data or attestations from a customer beyond what your policy rules automatically require.

Endpoint

POST https://api.brij.fi/brij.core.v1.partner.Service/AddCustomerRequirement

Request Body

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 365,
  "attestation": "VALIDATED_ID_DOCUMENT"
}

Or for data requirements:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 90,
  "data": "RESIDENTIAL_ADDRESS"
}

Request Parameters

Field Type Required Description
customerId string Yes Unique identifier for the customer
maxAgeDays integer No Maximum age in days for the requirement to be considered valid
data string No1 Type of data to request (see Data Types)
attestation string No1 Type of attestation to request (see Attestation Types)

Data Types

Request raw data from the customer. For the full list of supported data types, see Data Types.

Attestation Types

Request verified attestations from the customer. For the full list of supported attestation types, see Attestation Types.

Response

{
  "requirementId": "req_xyz789abc"
}
Field Type Description
requirementId string Unique identifier for the created requirement

Error Responses

Status Code Description
400 Invalid request parameters
401 Invalid or missing API key
404 Customer or partner not found
500 Internal server error

Examples

Example 1: Request ID Document Verification

Request a verified identity document from a customer:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 365,
  "attestation": "VALIDATED_ID_DOCUMENT"
}

Example 2: Request Proof of Address

Request residential address data:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 90,
  "data": "RESIDENTIAL_ADDRESS"
}

Example 3: Request AML Check

Request an anti-money laundering verification:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 30,
  "attestation": "AML_CHECK"
}

Example 4: Request Source of Funds

Request source of funds documentation:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 180,
  "data": "SOURCE_OF_FUNDS"
}

Example 5: Request Liveness Check

Request a liveness verification to confirm the customer is a real person:

{
  "customerId": "cust_abc123xyz",
  "maxAgeDays": 365,
  "attestation": "LIVENESS_CHECK"
}

  1. You must provide exactly one of data or attestation, not both.