digital-boards¶

Summary¶

GET agencies/{id}/digital-boards

Description¶

Return a list of digital boards for an agency

See Digital Board Response Fields for the digital board object

Tags: agencies

Parameters¶

Header Parameters¶

Name	Type	Required	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:10:10.000000Z",
            "updated_at": "2026-01-07T00:10:10.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-4Hr6",
            "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-b0ed4446-cefc-4fd5-96bd-548cd0438e40",
            "slug": "BreezyBillboardsBoard1234Sf2",
            "address": "37666 Erna Parks Apt. 888",
            "city": "Mafaldaborough",
            "region": "Washington",
            "postal_code": "60049-7792",
            "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": "31.81877300",
            "longitude": "-73.82156900",
            "cached_tags": null
        },
        {
            "board_identifier": "1234-NF",
            "name": "North Washington St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:10:10.000000Z",
            "updated_at": "2026-01-07T00:10:10.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-4Hr7",
            "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-217b841c-4cb7-45d9-8d3f-cb2c99bdcd55",
            "slug": "BreezyBillboardsBoard1234Nf2",
            "address": "20293 Hilton Prairie",
            "city": "New Virginiaberg",
            "region": "Kentucky",
            "postal_code": "86118",
            "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": "44.20206500",
            "longitude": "-113.21370600",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-SF",
            "name": "I29 and Dakota St, SF",
            "status": 1,
            "created_at": "2026-01-07T00:10:10.000000Z",
            "updated_at": "2026-01-07T00:10:10.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-4Hr8",
            "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-c50b15da-21f3-4106-9245-1ed0322d7e38",
            "slug": "BreezyBillboardsBoard5555Sf",
            "address": "279 Ephraim Extension",
            "city": "Angelborough",
            "region": "Michigan",
            "postal_code": "65193",
            "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": "43.01057200",
            "longitude": "-84.09042400",
            "cached_tags": null
        },
        {
            "board_identifier": "5555-NF",
            "name": "I29 and Dakota St, NF",
            "status": 1,
            "created_at": "2026-01-07T00:10:10.000000Z",
            "updated_at": "2026-01-07T00:10:10.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-4Hr9",
            "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-c4566470-e125-47b6-9bb4-457188417e84",
            "slug": "BreezyBillboardsBoard5555Nf",
            "address": "85513 Retha Villages",
            "city": "Abshireside",
            "region": "California",
            "postal_code": "51153",
            "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": "46.42638200",
            "longitude": "-81.27226000",
            "cached_tags": null
        }
    ]
}

Example Implementations¶

Bash (cURL)¶

curl --request GET \
    --get "https://api.lucit.app/api/v3/agencies/LCUID-LY-506fc585-77be-11ec-acb9-c2cdb617d190/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/agencies/LCUID-LY-506fc585-77be-11ec-acb9-c2cdb617d190/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/agencies/LCUID-LY-506fc585-77be-11ec-acb9-c2cdb617d190/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/agencies/LCUID-LY-506fc585-77be-11ec-acb9-c2cdb617d190/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()

← Back to agencies index | Back to main index