GET /api/v3/agencies/{lcuid}/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 | 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-08T21:29:25.000000Z",
"updated_at": "2026-10-08T21:29:25.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-4Lv4",
"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-35d7bd69-6282-483e-8537-3c1f4f7eaec1",
"slug": "BreezyBillboardsBoard1234Sf28",
"address": "49379 Demario Trafficway Suite 160",
"city": "Santinoport",
"region": "North Dakota",
"postal_code": "63698",
"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.82697700",
"longitude": "-106.39196900",
"cached_tags": null
},
{
"board_identifier": "1234-NF",
"name": "North Washington St, NF",
"status": 1,
"created_at": "2026-10-08T21:29:26.000000Z",
"updated_at": "2026-10-08T21:29:26.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-4Lv5",
"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-6e1bf8ae-52ca-4d79-8d59-1cfc0632d6c7",
"slug": "BreezyBillboardsBoard1234Nf28",
"address": "999 Johanna Parkway",
"city": "Lake Johnson",
"region": "Texas",
"postal_code": "20955",
"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": "48.13093700",
"longitude": "-88.03504000",
"cached_tags": null
},
{
"board_identifier": "5555-SF",
"name": "I29 and Dakota St, SF",
"status": 1,
"created_at": "2026-10-08T21:29:26.000000Z",
"updated_at": "2026-10-08T21:29:26.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-4Lv6",
"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-10e07b3d-4e54-406b-b7ec-f805eb2593b4",
"slug": "BreezyBillboardsBoard5555Sf2",
"address": "7277 Abbott Trafficway",
"city": "Rueckerberg",
"region": "Idaho",
"postal_code": "71306",
"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": "40.28843500",
"longitude": "-90.09435400",
"cached_tags": null
},
{
"board_identifier": "5555-NF",
"name": "I29 and Dakota St, NF",
"status": 1,
"created_at": "2026-10-08T21:29:27.000000Z",
"updated_at": "2026-10-08T21:29:27.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-4Lv7",
"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-203c1409-aac3-4761-8f46-f8cd573e2281",
"slug": "BreezyBillboardsBoard5555Nf2",
"address": "9248 Nikolaus Streets",
"city": "South Lolitaberg",
"region": "Indiana",
"postal_code": "73816",
"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": "45.09264500",
"longitude": "-79.41581700",
"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()