OCocean
Exclusion Lists

Get exclusion list

Changed on

Retrieve an exclusion list by id, including its size and items.

get/v2/exclusion-lists/{list_id}

Request

  • Base URL
    https://api.ocean.io
  • URL
    https://api.ocean.io/v2/exclusion-lists/{list_id}
  • Auth
    none declared

Path parameters

list_idstring required

Query parameters

apiTokenstring nullable

Headers

x-api-tokenstring nullable

Response

Successful Response

listIdstring required

Unique id of the list.

type'people' | 'companies' required

Whether the list holds people or companies.

namestring nullable

Display name of the list.

createdAtstring required

When the list was created, in ISO 8601 format.

itemCountinteger required

Number of items in the list.

itemsstring[] required

Up to the first 20,000 items in the list: company domains or LinkedIn handles.

Example response

{
  "listId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "type": "companies",
  "name": "Target accounts",
  "createdAt": "2026-09-23 08:00:00",
  "itemCount": 42,
  "items": [
    "ocean.io",
    "stripe.com"
  ]
}

Changes