---
title: "Get LLDP information for all network devices"
method: GET
path: "/object/lldp"
tags: ["lldp"]
---

# Get LLDP information for all network devices

`GET /object/lldp`

Retrieves Link Layer Discovery Protocol (LLDP) information, such as hostname, interface name, peer hostname, interface name, bridge, router, OS, timestamp, for all switches and hosts in the network. Refer to the LLDP model for all data collected.

## Query parameters

- `eq_timestamp` integer
- `count` integer
- `offset` integer

## Response `200`

successful operation

- LLDP[]
  - `schema` Schema, required
    - `props` object, required
    - `type` 'RECORD' | 'ENUM' | 'ARRAY' | 'MAP' | 'UNION' | 'FIXED' | 'STRING' | 'BYTES' | 'INT' | 'LONG' | 'FLOAT' | 'DOUBLE' | 'BOOLEAN' | 'NULL', required
    - `logicalType` LogicalType, required
      - `name` string, required
    - `hashCode` integer, required
    - `elementType` Schema, required — recursive
    - `aliases` string[], required
    - `namespace` string, required
    - `fields` Field[], required
      - `props` object, required
      - `name` string, required
      - `schema` Schema, required — recursive
      - `doc` string, required
      - `defaultValue` JsonNode, required
        - `elements` IteratorJsonNode, required
        - `fieldNames` IteratorString, required
        - `binary` boolean, required
        - `intValue` integer, required
        - `object` boolean, required
        - `int` boolean, required
        - `long` boolean, required
        - `double` boolean, required
        - `bigDecimal` boolean, required
        - `bigInteger` boolean, required
        - `textual` boolean, required
        - `boolean` boolean, required
        - `valueNode` boolean, required
        - `containerNode` boolean, required
        - `missingNode` boolean, required
        - `pojo` boolean, required
        - `number` boolean, required
        - `integralNumber` boolean, required
        - `floatingPointNumber` boolean, required
        - `numberValue` Number, required
        - `numberType` 'INT' | 'LONG' | 'BIG_INTEGER' | 'FLOAT' | 'DOUBLE' | 'BIG_DECIMAL', required
        - `longValue` integer, required
        - `bigIntegerValue` integer, required
        - `doubleValue` number, double, required
        - `decimalValue` number, required
        - `booleanValue` boolean, required
        - `binaryValue` string[], required
        - `valueAsInt` integer, required
        - `valueAsLong` integer, required
        - `valueAsDouble` number, double, required
        - `valueAsBoolean` boolean, required
        - `textValue` string, required
        - `valueAsText` string, required
        - `array` boolean, required
        - `fields` IteratorEntryStringJsonNode, required
        - `null` boolean, required
      - `order` 'ASCENDING' | 'DESCENDING' | 'IGNORE', required
      - `aliases` string[], required
      - `jsonProps` object, required
      - `objectProps` object, required
    - `types` Schema[], required
    - `fullName` string, required
    - `enumSymbols` string[], required
    - `doc` string, required
    - `valueType` Schema, required — recursive
    - `fixedSize` integer, required
    - `name` string, required
    - `error` boolean, required
    - `jsonProps` object, required
    - `objectProps` object, required
  - `opid` integer — Unique on-premise identifier
  - `hostname` string
  - `ifname` string
  - `timestamp` integer
  - `peer_hostname` string
  - `peer_ifname` string
  - `lldp_peer_bridge` boolean
  - `lldp_peer_router` boolean
  - `lldp_peer_station` boolean — Is lldp peer a station
  - `lldp_peer_os` string
  - `lldp_peer_osv` string
  - `db_state` string

---

[API](https://skmtc.dev/nvidia/apis/cumulus-netq-2-0-0-api.md) · [All operations](https://skmtc.dev/nvidia/apis/cumulus-netq-2-0-0-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nvidia/cumulus-netq-2-0-0-api/revisions/7f3260b68f45/schema)
