# Overview

Insights API v1 accepts an individual's NIK and selfie and returns a biometric
insight score for use within a digital certificate issuance workflow. It does
not define a public pass threshold, make an issuance decision, or issue a
digital certificate.

## Endpoint

`POST /api/v1/insights`

## How it works

1. Send a unique transaction ID, the individual's NIK, a Base64-encoded
   selfie, and the originating channel.
2. Privy validates the credentials and request fields.
3. Privy evaluates the selfie and returns a numeric score.
4. Use `client_transaction_id` and `transaction_id` to correlate the result
   with your request and Privy's processing record.

The API does not define a public pass threshold. Treat `score` as the insight
returned by Privy and follow the interpretation agreed for your integration.

## Next steps

- Follow the [Quickstart](/b2b-digital-certificate-issuance-support/insights-api/v1/quickstart) to submit a request.
- Review [Authentication](/b2b-digital-certificate-issuance-support/insights-api/v1/authentication) for Basic and Bearer HMAC options.
- Check [Request Fields](/b2b-digital-certificate-issuance-support/insights-api/v1/request-fields) before encoding a selfie.
