Get List

Retrieve the meta data for a given list.

INFO

Please note that due to the potential list sizes we are not returning the list content in API responses.

Authorization OAuth 2.0

This request requires OAuth 2.0 authorization.

Header Parameters

• • Authorization string required

    Bearer {ACCESS_TOKEN}

  • Content-Type string required

    application/json

  • Accept string required

    application/json

Path Parameters

• • id integer required

    List identifier.

Response Parameters

• • data object

    • id integer

      The ID of the list, can be used for future API requests to query list details or make updates.

    • name string

      The name of the list.

    • type string

      The type of list, one of: Affiliates Bank Routing Numbers Email Addresses Employer Names Telephone Numbers Social Security Numbers Last Four of Social Security Numbers ZIP Codes

    • deleted_at datetime

      Timestamp of when the list was archived, null if not archived.

    • created_at datetime

      Timestamp of when the list was created.

    • updated_at datetime

      Timestamp of when the list was last updated.

GET /api/v1/lead-management/lists/{listId}

cURL

curl --request POST \
    "https://api.decisioncloud.me/api/v1/list-manager/lists/{LIST_ID}" \
    --header "Authorization: Bearer {ACCESS_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \

JavaScript

const url = new URL(
    "https://api.decisioncloud.me/api/v1/list-manager/lists/{LIST_ID}"
);

const headers = {
    "Authorization": "Bearer {ACCESS_TOKEN}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

fetch(url, {
    method: "GET",
    headers,
}).then(response => response.json());

PHP

$client = new \GuzzleHttp\Client();
$response = $client->get(
    "https://api.decisioncloud.me/api/v1/list-manager/lists/{LIST_ID}",
    [
        "headers" => [
            "Authorization" => "Bearer {ACCESS_TOKEN}",
            "Content-Type" => "application/json",
            "Accept" => "application/json",
        ],
    ],
);
$body = $response->getJson();
print_r($body);

Python

import requests
import json

url = "https://api.decisioncloud.me/api/v1/list-manager/lists/{LIST_ID}"

headers = {
  "Authorization": "Bearer {ACCESS_TOKEN}",
  "Content-Type": "application/json",
  "Accept": "application/json"
}

response = requests.request("GET", url, headers=headers)
response.json()

200

{
    "data": {
        "id": 11,
        "name": "SSN List 1",
        "type": "Social Security Numbers",
        "deleted_at": null,
        "created_at": "2025-05-02T19:28:55.000000Z",
        "updated_at": "2025-05-02T22:01:12.000000Z"
    },
}