Skip to content

GET /api/v3/digital-boards

Summary

GET digital-boards

Description

Return a list of digitalBoards

See Digital Board for details on the digital board object

If you would like to return a list of digitalBoards for a specific agency, use the agencies/{lcuid}/digital-boards endpoint

Tags: digital-boards

Parameters

Header Parameters

Name Type Required Description Example
Authorization string ✓ Yes Bearer {AuthToken}
Content-Type string ✓ Yes application/json
Accept string ✓ Yes application/json
AppIdV3 string ✓ Yes LCUID-LAP-********-****-****-****-************

Responses

Response: 200

Description: Sample Response

Content Type: application/json

Schema

Type: object

Properties:

  • success (boolean)
  • digital_boards (array)
  • Array items: object Type: object

    Properties:

    • board_identifier (string)
    • name (string)
    • status (integer)
    • created_at (string)
    • updated_at (string)
    • network (integer)
    • width (integer)
    • height (integer)
    • hardware_provider (string)
    • software_provider (string)
    • description (string)
    • street_view_status (string)
    • street_view_review_status (integer)
    • xr_status (integer)
    • venue_taxonomy_id (integer)
    • board_class (string)
    • hash_id (string)
    • creative_width (integer)
    • creative_height (integer)
    • creative_is_upscaled (boolean)
    • digital_board_format (object) Type: object

    Properties:

    • code (string)
    • name (string)
    • width (integer)
    • height (integer)
    • min_ratio (number)
    • max_ratio (number)
    • meta (array)

    • board_class_description (string)

    • board_size_description (string)
    • options (object) Type: object

    Properties:

    • primary_image_public_url (string)
    • slot_count (string)
    • slot_length (string)
    • impressions_calc_method (string)
    • avg_daily_impressions (string)
    • facing_degrees (string)
    • facing_cardinal (string)
    • read (string)
    • pending_xr_image_url (string)

    • lcuid (string)

    • slug (string)
    • address (string)
    • city (string)
    • region (string)
    • postal_code (string)
    • country (string)
    • transact_channel_class (array)
    • Array items: string
    • transact_channel_class_description (string)
    • media_type_class (array)
    • Array items: string
    • media_type_class_description (string)
    • aspect_ratio (string)
    • latitude (string)
    • longitude (string)
    • cached_tags (string)
Example Response
{
    "success": true,
    "digital_boards": [
        {
            "board_identifier": "1234-SF",
            "name": "North Washington St, SF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsS",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-9cc0f8b5-a0c2-4c0d-ac02-f16e5d80774a",
            "slug": "BreezyBillboardsBoard1234Sf10",
            "address": "614 May Fields",
            "city": "Port Curt",
            "region": "Virginia",
            "postal_code": "52622",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "33.87985800",
            "longitude": "-100.37996000",
            "cached_tags": null
        },
        {
            "board_identifier": "1234-NF",
            "name": "North Washington St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsT",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-9a68fbbe-2c01-48f9-b8d4-c95adb63b505",
            "slug": "BreezyBillboardsBoard1234Nf8",
            "address": "1099 Nella Valley",
            "city": "Russborough",
            "region": "Maine",
            "postal_code": "39691-7986",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "35.24287000",
            "longitude": "-88.46397400",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-SF",
            "name": "I29 and Dakota St, SF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsU",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-feb8590a-87c9-4a7c-8c94-a12068c3a0bf",
            "slug": "BreezyBillboardsBoard5555Sf1",
            "address": "8289 Keeling Drive",
            "city": "South Pamela",
            "region": "Michigan",
            "postal_code": "85717",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "37.16603500",
            "longitude": "-119.17480100",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-NF",
            "name": "I29 and Dakota St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsV",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-b5b07349-a649-402e-8169-bcf498b8dcbf",
            "slug": "BreezyBillboardsBoard5555Nf1",
            "address": "9164 Edyth River",
            "city": "Port Walker",
            "region": "Montana",
            "postal_code": "23374-6855",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "24.45359600",
            "longitude": "-105.29578400",
            "cached_tags": null
        }
    ]
}

Example Implementations

Bash (cURL)

curl --request GET \
    --get "https://api.lucit.app/api/v3/digital-boards" \
    --header "Authorization: Bearer {AuthToken}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --header "AppIdV3: LCUID-LAP-********-****-****-****-************"

JavaScript (Fetch API)

const url = new URL(
    "https://api.lucit.app/api/v3/digital-boards"
);

const headers = {
    "Authorization": "Bearer {AuthToken}",
    "Content-Type": "application/json",
    "Accept": "application/json",
    "AppIdV3": "LCUID-LAP-********-****-****-****-************",
};

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

PHP (Guzzle)

$client = new \GuzzleHttp\Client();
$response = $client->get(
    'https://api.lucit.app/api/v3/digital-boards',
    [
        'headers' => [
            'Authorization' => 'Bearer {AuthToken}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
            'AppIdV3' => 'LCUID-LAP-********-****-****-****-************',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Python (Requests)

import requests
import json

url = 'https://api.lucit.app/api/v3/digital-boards'
headers = {
  'Authorization': 'Bearer {AuthToken}',
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'AppIdV3': 'LCUID-LAP-********-****-****-****-************'
}

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

Example Responses

200 Response

{
    "success": true,
    "digital_boards": [
        {
            "board_identifier": "1234-SF",
            "name": "North Washington St, SF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsS",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-9cc0f8b5-a0c2-4c0d-ac02-f16e5d80774a",
            "slug": "BreezyBillboardsBoard1234Sf10",
            "address": "614 May Fields",
            "city": "Port Curt",
            "region": "Virginia",
            "postal_code": "52622",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "33.87985800",
            "longitude": "-100.37996000",
            "cached_tags": null
        },
        {
            "board_identifier": "1234-NF",
            "name": "North Washington St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsT",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-9a68fbbe-2c01-48f9-b8d4-c95adb63b505",
            "slug": "BreezyBillboardsBoard1234Nf8",
            "address": "1099 Nella Valley",
            "city": "Russborough",
            "region": "Maine",
            "postal_code": "39691-7986",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "35.24287000",
            "longitude": "-88.46397400",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-SF",
            "name": "I29 and Dakota St, SF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsU",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-feb8590a-87c9-4a7c-8c94-a12068c3a0bf",
            "slug": "BreezyBillboardsBoard5555Sf1",
            "address": "8289 Keeling Drive",
            "city": "South Pamela",
            "region": "Michigan",
            "postal_code": "85717",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "37.16603500",
            "longitude": "-119.17480100",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-NF",
            "name": "I29 and Dakota St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:14:49.000000Z",
            "updated_at": "2026-01-07T00:14:49.000000Z",
            "network": 0,
            "width": 1024,
            "height": 768,
            "hardware_provider": "daktronics",
            "software_provider": "scala",
            "description": null,
            "street_view_status": null,
            "street_view_review_status": 0,
            "xr_status": 0,
            "venue_taxonomy_id": 301,
            "board_class": "App\\LuCore\\DigitalBoards\\DigitalBillboardBoardClass",
            "hash_id": "lch-4HsV",
            "creative_width": 1024,
            "creative_height": 768,
            "creative_is_upscaled": false,
            "digital_board_format": {
                "code": "oddblock",
                "name": "Wide Block",
                "width": 1000,
                "height": 833,
                "min_ratio": 1.0001,
                "max_ratio": 1.3999,
                "meta": []
            },
            "board_class_description": "Digital Billboard",
            "board_size_description": "1024x768",
            "options": {
                "primary_image_public_url": null,
                "slot_count": null,
                "slot_length": null,
                "impressions_calc_method": null,
                "avg_daily_impressions": null,
                "facing_degrees": null,
                "facing_cardinal": null,
                "read": null,
                "pending_xr_image_url": null
            },
            "lcuid": "LCUID-LB-b5b07349-a649-402e-8169-bcf498b8dcbf",
            "slug": "BreezyBillboardsBoard5555Nf1",
            "address": "9164 Edyth River",
            "city": "Port Walker",
            "region": "Montana",
            "postal_code": "23374-6855",
            "country": "US",
            "transact_channel_class": [
                "App\\LuCore\\DigitalBoards\\TransactChannels\\ContractTransactChannelClass"
            ],
            "transact_channel_class_description": "Contract",
            "media_type_class": [
                "App\\LuCore\\DigitalBoards\\MediaTypes\\ImageMediaTypeClass"
            ],
            "media_type_class_description": "Image",
            "aspect_ratio": "1.33000000",
            "latitude": "24.45359600",
            "longitude": "-105.29578400",
            "cached_tags": null
        }
    ]
}

← Back to digital-boards index | Back to main index