---
title: "List KYC Results"
method: GET
path: "/v2/consumers/{consumer_id}/kyc-results/"
tags: ["consumers"]
---

# List KYC Results

`GET /v2/consumers/{consumer_id}/kyc-results/`

List the KYC results for a consumer, one per Persona inquiry. When an inquiry has produced several results, the one with the most advanced status is returned (approved, then declined or failed, then expired, needs_review, completed, pending, created), with ties broken by the most recent result. Results are ordered by `created_date`, newest first.

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `page_size` integer

## Headers

- `Authorization` string, required

## Response `200`

- ConsumersListKYCResultsResponse200
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` KYCResultList[], required
    - `id` string, uuid, required — Unique ID of the KYC result.
    - `inquiry_id` string, required — ID of the Persona inquiry that produced this result.
    - `status` 'created' | 'pending' | 'completed' | 'needs_review' | 'expired' | 'failed' | 'declined' | 'approved', required — Status of the inquiry.
    - `kyc_reason` 'KYC' | 'profile_update' — What triggered the KYC check.
    - `created_date` string, date-time, required

## Other responses

- `404` — Consumer not found or does not belong to this partner

---

[API](https://skmtc.net/upwardli/apis/api-reference.md) · [All operations](https://skmtc.net/upwardli/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upwardli/api-reference/revisions/8a237f1f704f/schema)