One view with its filter and syncs

Opens one saved view (a saved list) by its name or id. It shows how many people are in it, its filter, and where it sends people. It returns its filter, its match_count and its syncs. The filter uses the words of get_filter_options, in the same shape that save_view takes. match_count is how many people the view shows now. Each sync comes with its status, its last send and its failed sends. list_deliveries shows what each send carried and what the receiver answered. Pass it the destination id of a sync. A hand-picked view also says how many LinkedIn links from add_to_view Ziplined still looks up, and which found nobody. Use when: The user names one view. They ask how many people are in it, what its filter is, or whether its syncs send. Also before changing a view (start from its filter). The view takes the name as the user says it. Do not use for: All views at once (use list_views instead). The people themselves (use search_people with view instead). A check before the user sends or syncs the people in a view (use save_sync or send_people instead). Those take the view name and check the view and its syncs themselves. Example: {"view":"Warm leads NL"}

GET

views

{id}

curl --request GET \
  --url https://api.ziplined.io/v1/views/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ziplined.io/v1/views/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ziplined.io/v1/views/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ziplined.io/v1/views/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ziplined.io/v1/views/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "view": {
    "id": "<string>",
    "name": "<string>",
    "resource": "people",
    "kind": "filter",
    "icon": "<string>",
    "member_count": 123,
    "system_key": "your_audience_people",
    "sync_setup_url": "<string>",
    "sync_setup_urls": {
      "clay": "<string>",
      "sheets": "<string>"
    },
    "created_at": "<string>",
    "last_used_at": "<string>",
    "filter": {
      "status": [
        "lead"
      ],
      "country": [
        "<string>"
      ],
      "warmth": [
        "hot"
      ],
      "seniority": [
        "C-Level"
      ],
      "connection_degree": [
        "<string>"
      ],
      "industry": [
        "<string>"
      ],
      "is_premium": true,
      "is_verified": true,
      "min_followers": 1,
      "min_connections": 1,
      "first_engaged_since": "<string>",
      "first_engaged_until": "<string>",
      "first_reacted_since": "<string>",
      "company": [
        "<string>"
      ],
      "job_title": [
        "<string>"
      ],
      "company_size_min": 1,
      "company_size_max": 1,
      "post": [
        "<string>"
      ],
      "trend": [
        "new"
      ],
      "has_email": true,
      "has_phone": true,
      "sent": true,
      "in_view": [
        "<string>"
      ],
      "not_in_view": [
        "<string>"
      ],
      "activity": [
        "<string>"
      ]
    },
    "syncs": [
      {
        "id": "<string>",
        "destination": {
          "id": "<string>",
          "provider": "<string>",
          "name": "<string>",
          "status": "connected"
        },
        "status": "active",
        "new_people": true,
        "activity": true,
        "add_email": true,
        "add_phone": true,
        "last_delivery": {
          "status": "<string>",
          "at": "<string>"
        },
        "failed_deliveries": 123
      }
    ]
  },
  "match_count": 123,
  "app_url": "<string>",
  "empty_reason": "view_empty",
  "looking_up": 123,
  "not_found": [
    "<string>"
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

The name or the id of the view, from list_views. A People view and a Companies view can share a name; then add the subject, as in "Your audience (companies)".

Required string length: 1 - 200

Response

The result

view

object

required

Show child attributes

match_count

integer | null

required

How many people the view shows now: the count in its heading in the app. Null when the count failed. The lists hide some people, such as the people that the "Always left out" rules leave out.

app_url

string

required

empty_reason

enum<string>

Available options:

view_empty

looking_up

integer

A hand-picked view: how many LinkedIn links from add_to_view Ziplined still looks up. The people appear when it is done.

not_found

string[]

A hand-picked view: the LinkedIn links of the last 7 days that found nobody. They cost nothing.

One view with its filter and syncs

curl --request GET \
  --url https://api.ziplined.io/v1/views/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.ziplined.io/v1/views/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.ziplined.io/v1/views/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.ziplined.io/v1/views/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.ziplined.io/v1/views/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "view": {
    "id": "<string>",
    "name": "<string>",
    "resource": "people",
    "kind": "filter",
    "icon": "<string>",
    "member_count": 123,
    "system_key": "your_audience_people",
    "sync_setup_url": "<string>",
    "sync_setup_urls": {
      "clay": "<string>",
      "sheets": "<string>"
    },
    "created_at": "<string>",
    "last_used_at": "<string>",
    "filter": {
      "status": [
        "lead"
      ],
      "country": [
        "<string>"
      ],
      "warmth": [
        "hot"
      ],
      "seniority": [
        "C-Level"
      ],
      "connection_degree": [
        "<string>"
      ],
      "industry": [
        "<string>"
      ],
      "is_premium": true,
      "is_verified": true,
      "min_followers": 1,
      "min_connections": 1,
      "first_engaged_since": "<string>",
      "first_engaged_until": "<string>",
      "first_reacted_since": "<string>",
      "company": [
        "<string>"
      ],
      "job_title": [
        "<string>"
      ],
      "company_size_min": 1,
      "company_size_max": 1,
      "post": [
        "<string>"
      ],
      "trend": [
        "new"
      ],
      "has_email": true,
      "has_phone": true,
      "sent": true,
      "in_view": [
        "<string>"
      ],
      "not_in_view": [
        "<string>"
      ],
      "activity": [
        "<string>"
      ]
    },
    "syncs": [
      {
        "id": "<string>",
        "destination": {
          "id": "<string>",
          "provider": "<string>",
          "name": "<string>",
          "status": "connected"
        },
        "status": "active",
        "new_people": true,
        "activity": true,
        "add_email": true,
        "add_phone": true,
        "last_delivery": {
          "status": "<string>",
          "at": "<string>"
        },
        "failed_deliveries": 123
      }
    ]
  },
  "match_count": 123,
  "app_url": "<string>",
  "empty_reason": "view_empty",
  "looking_up": 123,
  "not_found": [
    "<string>"
  ]
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

{
  "error": {
    "code": "<string>",
    "message": "<string>"
  }
}

People

Companies

Posts

Engagements

Insights

Views

Audiences

ICP

Sources

Account

Credits

Integrations

One view with its filter and syncs

Authorizations

Path Parameters

Response