---
title: "Search list entries"
method: GET
path: "/api/v2/lists/entries"
tags: ["Screening and Reference"]
---

# Search list entries

`GET /api/v2/lists/entries`

Search restricted-party list ENTRIES (institution-only) — programmes, aliases, country, ids, with bitemporal as-of selection. Requires a plan with Restricted-party screening access (`can_use_screening`) — the Corporate & Supply Chain plan and above.

## Query parameters

- `source` string
- `search` string
- `country` string
- `program` string
- `entity_id` string
- `active_on` string
- `limit` integer
- `cursor` string
- `sort` 'name' | 'recent'

## Response `200`

Search list entries.

- object
  - `success` boolean
  - `data` object[]
    - `entry_uid` string
    - `source_key` string
    - `name` string
    - `aliases` string[]
    - `entity_kind` string
    - `country_iso3` string
    - `programs` string[]
    - `legal_basis` string
    - `source_url` string
    - `ids` object
      - `csl_id` string
      - `lei` string
    - `first_seen_date` string
    - `last_seen_date` string
    - `active` boolean
  - `pagination` object
    - `limit` integer
    - `cursor` unknown
    - `next_cursor` unknown
  - `sort` string
  - `applied_filters` object
    - `country` string
    - `q` string

## Other responses

- `401` — Missing/invalid API key
- `403` — Plan required (PLAN_REQUIRED) — the caller's plan does not carry the required source entitlement.
- `500` — Server error

---

[API](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2.md) · [All operations](https://skmtc.net/gdeltcloud/apis/gdelt-cloud-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gdeltcloud/gdelt-cloud-api-v2/versions/01aaa6255180/schema)