Lead IDs

Retrieve a paginated list of lead ids on a given date.

INFO

This endpoint uses "cursor" pagination which is aimed to offer better performance.

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

Query Parameters

• date string optional

  The date to pull the lead ids from. Must be a valid date in ISO 8601 format YYYY-MM-DD.

• datetime string optional

  The datetime to pull the lead ids from. Must be a valid datetime in ISO 8601 format YYYY-MM-DDTHH:mm:ssZ.

• per_page integer optional

  The per_page to paginate the results. Defaults to 100.

Response Parameters

• data array

  • integer

    The collection of lead IDs.
• links array

  • first nullable string

    INFO

    This value is not used for cursor pagination.

  • last nullable string

    INFO

    This value is not used for cursor pagination.

  • prev nullable string

    Full URL to the previous page of results.

  • next nullable string

    Full URL to the next page of results.

• meta array

  • path string

    Base URL for this endpoint.

  • per_page integer

    Maximum number of results per page.

  • next_cursor nullable string

    Cursor that points to the next page of results.

  • prev_cursor nullable string

    Cursor that points to the previous page of results.

GET /api/v1/lead-data/lead-ids

cURL

curl --request GET \
    --get "https://api.decisioncloud.me/api/v1/lead-data/lead-ids?date=2024-01-05&per_page=3" \
    --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/lead-data/lead-ids?date=2024-01-05&per_page=3"
);

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/lead-data/lead-ids?date=2024-01-05&per_page=3',
    [
        'headers' => [
            'Authorization' => 'Bearer {ACCESS_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Python

import requests
import json

url = 'https://api.decisioncloud.me/api/v1/lead-data/lead-ids?date=2024-01-05&per_page=3'
headers = {
  'Authorization': 'Bearer {ACCESS_TOKEN}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

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

200

{
    "data": [
        1,
        2,
        3,
    ],
    "links": {
        "first": null,
        "last": null,
        "prev": null,
        "next": "https://api.decisioncloud.me/api/v1/lead-data/lead-ids?date=2024-01-05&per_page=3&cursor=eyJkY19mYWN0LmxvYW5tc19wb3N0X2lkIjoxLCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9"
    },
    "meta": {
        "path": "https://api.decisioncloud.me/api/v1/lead-data/lead-ids",
        "per_page": 3,
        "next_cursor": "eyJkY19mYWN0LmxvYW5tc19wb3N0X2lkIjoxLCJfcG9pbnRzVG9OZXh0SXRlbXMiOnRydWV9",
        "prev_cursor": null
    }
}