List identities

get/v1/senderIdentities/list

This API lists the details of all the existing sender identities under your BoldSign organization account. The sender identity details like name, email address, approval status, approved date, etc., will be displayed.

Code snippet

curl -X 'GET' \
  'https://api.boldsign.com/v1/senderIdentities/list?PageSize=10&Page=1' \
      -H 'accept: application/json' \
      -H 'X-API-KEY: {your API key}'
            var apiClient = new ApiClient("https://api.boldsign.com", "{your API key}");
            var senderIdentityClient = new SenderIdentityClient(apiClient);
            var senderIdentities = senderIdentityClient.ListSenderIdentities(1, 10);
import requests
url = "https://api.boldsign.com/v1/senderIdentities/list?PageSize=10&Page=1"
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');
const response = await axios.get('https://api.boldsign.com/v1/senderIdentities/list',
{
  params: {
    'PageSize': '10',
    'Page': '1'
  },
  headers: {
    'accept': 'application/json',
    'X-API-KEY': '{your API key}'
  }
});

Query parameters

PageSizeIntegerSize of the page to list the exiting sender identities.
PageIntegerRequiredPage index of the sender identities list.
SearchStringUsers can be listed by the search key present in the sender identities like sender identity name and email address.

Example response

200 Success

{
  "result": [
    {
      "name": "Luther Cooper",
      "email": "luthercooper@cubeflakes.com",
      "status": "Pending",
      "createdBy": "516f5251-xxxx-xxxx-xxxx-04b5e34c5968",
      "approvedDate": ""
    }
  ],
  "pageDetails": {
    "pageSize": 10,
    "page": 1,
    "totalRecordsCount": 1,
    "totalPages": 1,
    "sortedColumn": "createdDate",
    "sortDirection": "DESC"
  }
}