List Contacts

get/v1-beta/contacts/list

This API allows you to get a list of contacts with access to the specified account. If a searchKey query is added to this API, you will get a response based on the searchKey keyword.

Code snippet

curl -X 'GET' \
  'https://api.boldsign.com/v1-beta/contacts/list?PageSize=10&Page=1&SearchKey=xxxx&ContactType=MyContacts' \
  -H 'accept: application/json' \
  -H 'X-API-KEY: {your API key}'
// accessing metadata property requires beta version of the SDK at least v4.10.18-beta
var apiClient = new ApiClient("https://api.boldsign.com", "apikey");
var contactClient = new ContactClient(apiClient);
var result = await contactClient.ContactList(1,10).ConfigureAwait(false);
import requests

url = "https://api.boldsign.com/v1-beta/contacts/list?PageSize=10&Page=1&SearchKey=xxxx&ContactType=MyContacts"
payload={}
headers = {
  'accept': 'application/json',
  'X-API-KEY': '{your API key}'
}
response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)
const axios = require('axios');
async function fetchData() {
        const response = await axios.get('https://api.boldsign.com/v1-beta/contacts/list', {
            params: {
                PageSize: '10',
                Page: '1',
                SearchKey: '',
                ContactType: 'AllContacts',
            },
            headers: {
                accept: 'application/json',
                'X-API-KEY': 'your API key',
            },
        });

        console.log(JSON.stringify(response.data));
    }
fetchData();
<?php
require_once "vendor/autoload.php";
use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Request;

$client = new Client();

$headers = [
  'accept' => 'application/json',
  'X-API-KEY' => '{your API key}'
];
$request = new Request('GET', 'https://api.boldsign.com/v1-beta/contacts/list?PageSize=10&Page=1&SearchKey=xxxx&ContactType=MyContacts', $headers);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

Request body

PageSizeintegerThe number of results returned per page. The value must be between 1 and 100. The default value is 10.
PageintegerRequiredThe page number of the contact page to return.
SearchKeystringReturns contacts of the searchKey results for a keyword.
ContactTypestringType of Contacts such as MyContacts and AllContacts.

Example response

200 Success

{
  "pageDetails": {
    "pageSize": 10,
    "page": 1,
    "totalRecordsCount": 1
  },
  "result": [
    {
      "id": "e892ea92-xxxx-xxxx-xxxx-bbdbcaa5xxxxc_pgVgo",
      "name": "xxxxx",
      "email": "cooper@cubeflakes.com",
      "companyName": "syncfusion",
      "role": "Engineer",
      "phoneNumber": {
        "countryCode": "+91",
        "number": "xxxxx78901"
      }
    }
  ]
}