---
title: "listULs"
method: GET
path: "/uls"
tags: ["ul"]
---

# listULs

`GET /uls`

This method returns a list of Unsolved Latent that match the search criteria.

## Query parameters

- `pageSize` integer
- `pageIndex` integer
- `status` 'UNSOLVED' | 'SOLVED'

## Response `200`

OK

- ListULsResponse
  - `data` UL[]
    - `uguid` string — Globally unique ID of the UL.
    - `status` 'UNSOLVED' | 'SOLVED' | 'ENQUEUED' | 'FAILED' — UL Status.
    - `creationTime` integer — Timestamp, in milliseconds, of UL creation.
    - `personPguid` string — PGUID of the person the UL was matched against. Only present when the UL has status RESOLVED.
    - `personTguid` string — TGUID of the person the UL was matched against. Only present when the UL has status RESOLVED.
    - `candidates` Match[]
      - `matchedPersonPguid` string — PGUID of the person the candidate was matched against.
      - `matchedPersonTguid` string — TGUID of the person the candidate was matched against.
      - `biometricMatches` BiometricMatch[] — Information about the match.
        - `score` integer — Score of the match.
        - `queryIndex` integer — Index of the biometric data that was sent and caused a match.
        - `referenceIndex` integer — Index of the biometric data, from the already enrolled person, which matched.
        - `minutia` Minutiae[] — Array of minutia matches. Returned only for latent searches.
          - `query` integer — Index of Minutiae, from the provided biometric data, which was involved in the match.
          - `reference` integer — Index of Minutiae, from biometric data already in the database, which was involved in the match.
    - `linkedULs` string[] — List of UGUIDs if ULs that were linked against this UL.
    - `fragment` Fragment
      - `id` string — ID of the fragment.
      - `caseId` string — ID of case the fragment is associated to.
      - `image` Biometric
        - `index` integer
        - `content` string
        - `width` integer
        - `height` integer
        - `resolution` integer
      - `template` Biometric
        - `index` integer
        - `content` string
        - `width` integer
        - `height` integer
        - `resolution` integer
    - `ulAnalysis` ULAnalysis
      - `user` string — Username of user that solved UL.
      - `timestamp` integer — Timestamp, in milliseconds, of when UL was solved.
    - `isSearchable` boolean — Flag that indicates whether the UL's fragment is already registered and searchable.
    - `failReason` string — If failed, this field indicates the reason.
  - `pagination` Pagination
    - `total` integer — Total number of elements that matched the selection criteria.
    - `count` integer — Number of elements in the response.
    - `pageSize` integer — Size of the page.
    - `currentPage` integer — Number of the current page.
    - `totalPages` integer — Number of total pages.

## Other responses

- `400` — Validation Error
- `500` — Internal Error

---

[API](https://skmtc.net/griaule/apis/gbds-api.md) · [All operations](https://skmtc.net/griaule/apis/gbds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griaule/gbds-api/versions/fa80f482ec5e/schema)