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-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
}
]
}