---
title: "Get Interfaces"
method: GET
path: "/share/interfaces"
tags: ["Share"]
---

# Get Interfaces

`GET /share/interfaces`

Candidate addresses, best guess first.

Machines with virtual adapters routinely surface several, so the caller is
expected to show this list rather than silently trust the first entry.

## Response `200`

Successful Response

- GetInterfacesResponse
  - `success` boolean, required
  - `data` ShareInterface[], required
    - `interface` string, required
    - `ip` string, required
    - `is_default_route` boolean, required
    - `looks_virtual` boolean, required
    - `is_up` boolean, required
    - `is_link_local` boolean, required

## Other responses

- `500` — Internal Server Error

## Changes

- **2026-08-06** `a6c11e6b42e4` — 2 info
  - added the non-success response with the status `500`
  - added the required property `data/items/is_link_local` to the response with the `200` status
- **2026-08-06** `1f470deef917` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/aossie-org/apis/pictopy/changes/share/interfaces/get.md)

---

[API](https://skmtc.dev/aossie-org/apis/pictopy.md) · [All operations](https://skmtc.dev/aossie-org/apis/pictopy/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aossie-org/pictopy/revisions/a6c11e6b42e4/schema)