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:
objectType:objectProperties:
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-10-09T15:54:14.000000Z",
"updated_at": "2026-10-09T15:54:14.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-4M1i",
"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-5a4ff27b-cba2-438b-bc54-587806d0abb9",
"slug": "BreezyBillboardsBoard1234Sf51",
"address": "79333 Judge Ridge Suite 644",
"city": "Verdamouth",
"region": "Pennsylvania",
"postal_code": "04244-2112",
"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.91693700",
"longitude": "-121.10808100",
"cached_tags": null
},
{
"board_identifier": "1234-NF",
"name": "North Washington St, NF",
"status": 1,
"created_at": "2026-10-09T15:54:15.000000Z",
"updated_at": "2026-10-09T15:54:15.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-4M1j",
"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-d817363a-446d-4943-834f-dc6ce85d6fb8",
"slug": "BreezyBillboardsBoard1234Nf43",
"address": "913 Dicki Pike",
"city": "South Jalyn",
"region": "Michigan",
"postal_code": "72035-3575",
"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.68987600",
"longitude": "-121.00581700",
"cached_tags": null
},
{
"board_identifier": "5555-SF",
"name": "I29 and Dakota St, SF",
"status": 1,
"created_at": "2026-10-09T15:54:16.000000Z",
"updated_at": "2026-10-09T15:54:16.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-4M1k",
"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-f1c7331d-e2ec-43aa-946a-74c6be1c2de1",
"slug": "BreezyBillboardsBoard5555Sf6",
"address": "1788 Pedro Station Suite 804",
"city": "North Wadeburgh",
"region": "South Carolina",
"postal_code": "13716",
"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": "25.55944000",
"longitude": "-122.89211600",
"cached_tags": null
},
{
"board_identifier": "5555-NF",
"name": "I29 and Dakota St, NF",
"status": 1,
"created_at": "2026-10-09T15:54:17.000000Z",
"updated_at": "2026-10-09T15:54:17.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-4M1l",
"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-7f4bc784-150b-4a12-9a91-349fcb9e8455",
"slug": "BreezyBillboardsBoard5555Nf6",
"address": "47749 Davis Keys",
"city": "Hellerstad",
"region": "Nevada",
"postal_code": "03696-8335",
"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.42815100",
"longitude": "-74.76601000",
"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-10-09T15:54:14.000000Z",
"updated_at": "2026-10-09T15:54:14.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-4M1i",
"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-5a4ff27b-cba2-438b-bc54-587806d0abb9",
"slug": "BreezyBillboardsBoard1234Sf51",
"address": "79333 Judge Ridge Suite 644",
"city": "Verdamouth",
"region": "Pennsylvania",
"postal_code": "04244-2112",
"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.91693700",
"longitude": "-121.10808100",
"cached_tags": null
},
{
"board_identifier": "1234-NF",
"name": "North Washington St, NF",
"status": 1,
"created_at": "2026-10-09T15:54:15.000000Z",
"updated_at": "2026-10-09T15:54:15.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-4M1j",
"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-d817363a-446d-4943-834f-dc6ce85d6fb8",
"slug": "BreezyBillboardsBoard1234Nf43",
"address": "913 Dicki Pike",
"city": "South Jalyn",
"region": "Michigan",
"postal_code": "72035-3575",
"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.68987600",
"longitude": "-121.00581700",
"cached_tags": null
},
{
"board_identifier": "5555-SF",
"name": "I29 and Dakota St, SF",
"status": 1,
"created_at": "2026-10-09T15:54:16.000000Z",
"updated_at": "2026-10-09T15:54:16.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-4M1k",
"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-f1c7331d-e2ec-43aa-946a-74c6be1c2de1",
"slug": "BreezyBillboardsBoard5555Sf6",
"address": "1788 Pedro Station Suite 804",
"city": "North Wadeburgh",
"region": "South Carolina",
"postal_code": "13716",
"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": "25.55944000",
"longitude": "-122.89211600",
"cached_tags": null
},
{
"board_identifier": "5555-NF",
"name": "I29 and Dakota St, NF",
"status": 1,
"created_at": "2026-10-09T15:54:17.000000Z",
"updated_at": "2026-10-09T15:54:17.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-4M1l",
"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-7f4bc784-150b-4a12-9a91-349fcb9e8455",
"slug": "BreezyBillboardsBoard5555Nf6",
"address": "47749 Davis Keys",
"city": "Hellerstad",
"region": "Nevada",
"postal_code": "03696-8335",
"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.42815100",
"longitude": "-74.76601000",
"cached_tags": null
}
]
}