---
title: "List organisations using advanced filters"
method: POST
path: "/v1/workspaces/{workspaceUuid}/organisations"
tags: ["Organisations"]
---

# List organisations using advanced filters

`POST /v1/workspaces/{workspaceUuid}/organisations`

## Path parameters

- `workspaceUuid` string, uuid, required

## Query parameters

- `segmentUuid` string, uuid
- `page` integer
- `size` integer

## Request body

- object
  - `filters` FilterGroup, required
    - `operator` 'AND' | 'OR', required — The logical operator for the group. 'AND' means all conditions must match, 'OR' means at least one condition must match.
    - `conditions` union[], required — A list of filter conditions or nested filter groups.
      - union
        - FilterCondition
          - `field` string, required — The field to filter on.
          - `comparison` 'equal' | 'not_equal' | 'contains' | 'not_contains' | 'starts_with' | 'ends_with' | 'doesnt_start_with' | 'doesnt_end_with' | 'in' | 'not_in' | 'between' | 'not_between' | 'greater_than' | 'less_than' | 'greater_than_or_equal' | 'less_than_or_equal' | 'less_than_x_units_ago' | 'more_than_x_units_ago' | 'set' | 'not_set' | 'is_true' | 'is_false', required — The comparison operator to use. The relative date comparisons (`less_than_x_units_ago`, `more_than_x_units_ago`) require a numeric `value` and a `unit`.
          - `value` union — The value(s) for the comparison. Not required for `set` and `not_set`.
            - string
            - number
            - boolean
            - string[]
            - number[]
          - `unit` 'second' | 'minute' | 'hour' | 'day' | 'week' | 'month' | 'year' — The date unit. Required for the relative date comparisons (`less_than_x_units_ago`, `more_than_x_units_ago`), not allowed otherwise.
        - FilterGroup — recursive

## Response `200`

A paginated list of organisations

- object
  - `current_page` integer
  - `last_page` integer
  - `per_page` integer
  - `total` integer
  - `next_page_url` string, nullable
  - `prev_page_url` string, nullable
  - `first_page_url` string, nullable
  - `last_page_url` string, nullable
  - `path` string, nullable
  - `from` integer, nullable
  - `to` integer, nullable
  - `data` OrganisationOrganisation[]
    - `uuid` string, uuid, required
    - `name` string, required
    - `website` string, required
    - `first_seen` string, date-time, required
    - `last_seen` string, date-time, required
    - `logo` string, nullable
    - `address` ValueAddress
      - `street` string, required
      - `street_number` string, nullable
      - `postal_code` string, nullable
      - `address` string, required
      - `full_address` string, required
      - `city` string, required
      - `state` string, required
      - `country` string, nullable
      - `latitude` number, nullable
      - `longitude` number, nullable
    - `founded` number, nullable
    - `size` '1-10 employees' | '11-50 employees' | '51-200 employees' | '201-500 employees' | '501-1000 employees' | '1001-5000 employees' | '5001-10,000 employees' | '10,001+ employees'
    - `industry` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `profiles` OrganisationSocialProfile[], required
      - `name` string, required
      - `handle` string, nullable
      - `url` string, nullable
    - `tags` string[], required
    - `segments` OrganisationSegment[], required
      - `uuid` string, uuid, required
      - `name` string, required
    - `total_pageviews` integer, nullable
    - `total_time_on_site` string, nullable
    - `visitor_locations` string[]
  - `success` boolean

---

[API](https://skmtc.dev/snitcher/apis/snitcher-api.md) · [All operations](https://skmtc.dev/snitcher/apis/snitcher-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/snitcher/snitcher-api/revisions/cb6fa68e7c8e/schema)