Skip to main content
POST
/
v1
/
workspaces
/
{workspaceUuid}
/
organisations
List organisations using advanced filters
curl --request POST \
  --url https://api.snitcher.com/v1/workspaces/{workspaceUuid}/organisations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": {
    "operator": "AND",
    "conditions": [
      {
        "field": "<string>",
        "comparison": "equal",
        "value": "<string>",
        "unit": "second"
      }
    ]
  }
}
'
{
  "current_page": 1,
  "last_page": 10,
  "per_page": 15,
  "total": 150,
  "next_page_url": "https://api.example.com/v1/workspaces?page=2",
  "prev_page_url": null,
  "first_page_url": "https://api.example.com/v1/workspaces?page=1",
  "last_page_url": "https://api.example.com/v1/workspaces?page=10",
  "path": "https://api.example.com/v1/workspaces",
  "from": 1,
  "to": 15,
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Pirate Inc.",
      "website": "https://pirateinc.com",
      "first_seen": "2021-01-01T00:00:00Z",
      "last_seen": "2021-01-01T00:00:00Z",
      "profiles": [
        {
          "name": "Twitter",
          "handle": "@pirateinc",
          "url": "https://twitter.com/pirateinc"
        }
      ],
      "tags": [
        "<string>"
      ],
      "segments": [
        {
          "uuid": "550e8400-e29b-41d4-a716-446655440000",
          "name": "Hot leads"
        }
      ],
      "logo": "https://pirateinc.com/logo.png",
      "address": {
        "street": "Hollywood Blvd",
        "address": "Hollywood Blvd 123",
        "full_address": "Hollywood Blvd 123, Los Angeles, California, US",
        "city": "Los Angeles",
        "state": "California",
        "street_number": "123",
        "postal_code": "90028",
        "country": "US",
        "latitude": "34.0522",
        "longitude": "-118.2437"
      },
      "founded": "2000",
      "size": "1-10 employees",
      "industry": "Piracy",
      "phone": "+49 123 4567890",
      "email": "[email protected]"
    }
  ],
  "success": true
}

Authorizations

​
Authorization
string
header
required

Enter your personal access token (PAT) to authenticate

Path Parameters

​
workspaceUuid
string<uuid>
required

The UUID of the workspace

Example:

"550e8400-e29b-41d4-a716-446655440000"

Query Parameters

​
segmentUuid
string<uuid>

Optional segment UUID for filtering organisations

Example:

"550e8400-e29b-41d4-a716-446655440000"

​
page
integer

The page number for pagination

Example:

1

​
size
integer

The number of organisations per page (1-1000)

Required range: 1 <= x <= 1000
Example:

10

Body

application/json
​
filters
object
required

Response

200 - application/json

A paginated list of organisations

​
current_page
integer
Example:

1

​
last_page
integer
Example:

10

​
per_page
integer
Example:

15

​
total
integer
Example:

150

​
next_page_url
string | null
Example:

"https://api.example.com/v1/workspaces?page=2"

​
prev_page_url
string | null
Example:

null

​
first_page_url
string | null
Example:

"https://api.example.com/v1/workspaces?page=1"

​
last_page_url
string | null
Example:

"https://api.example.com/v1/workspaces?page=10"

​
path
string | null
Example:

"https://api.example.com/v1/workspaces"

​
from
integer | null
Example:

1

​
to
integer | null
Example:

15

​
data
object[]
​
success
boolean
Example:

true