---
title: "Get node routing table"
method: GET
path: "/v1/objects/{object-id}/routing-table"
tags: ["Objects"]
---

# Get node routing table

`GET /v1/objects/{object-id}/routing-table`

Read the IP routing table of the given node. Returns an empty entry list with a null timestamp when the routing table has never been collected for this node.

## Path parameters

- `object-id` integer, required

## Response `200`

Routing table retrieved successfully

- RoutingTable — IP routing table of a node
  - `timestamp` string, date-time, nullable — When the table was collected. Null when it has never been collected for this node.
  - `entries` Route[]
    - `destination` InetAddress
      - `family` integer — IP address family
      - `address` string — IP address in text form. Omitted entirely for unset (AF_UNSPEC) addresses.
      - `prefixLength` integer — IP address prefix length
    - `nextHop` InetAddress
      - `family` integer — IP address family
      - `address` string — IP address in text form. Omitted entirely for unset (AF_UNSPEC) addresses.
      - `prefixLength` integer — IP address prefix length
    - `interfaceIndex` integer — Outgoing interface index (0 if unknown)
    - `interfaceName` string, nullable — Name of the matching interface object. Null when no interface object matches the index.
    - `type` integer — Route type, RFC1213 ipRouteType (1=other, 2=invalid, 3=direct, 4=indirect)
    - `typeText` string — Textual representation of the route type
    - `metric` integer — Route metric
    - `protocol` integer — Routing protocol, RFC1213 ipRouteProto (2=local, 8=RIP, 13=OSPF, 14=BGP, ...)
    - `protocolText` string — Textual representation of the routing protocol

## Other responses

- `400` — Invalid object ID or object is not a node
- `401` — Unauthorized
- `403` — User does not have read access to given object
- `404` — Object with given ID does not exist

---

[API](https://skmtc.net/netxms/apis/netxms-api.md) · [All operations](https://skmtc.net/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/netxms/netxms-api/revisions/070b10a450e2/schema)