OCocean
Exclusion Lists

Get exclusion lists

Changed on

Retrieve all exclusion lists for the organization.

get/v2/exclusion-lists

Request

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

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.

Example response

[
  {
    "listId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "type": "companies",
    "name": "Target accounts",
    "createdAt": "2026-09-23 08:00:00"
  }
]

Changes