> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nerves-hub.org/llms.txt
> Use this file to discover all available pages before exploring further.

# List the Network Identities a Device holds

> The keys this device has reported holding on other networks — an iroh
endpoint id, a NetBird, Tailscale or WireGuard public key.

`service` is the protocol. `instance` names which endpoint of it, for a
device running more than one — an iroh console and an iroh application, say.
Anything running a single endpoint of a service uses `default`.




## OpenAPI

````yaml https://manage.nervescloud.com/api/openapi get /api/orgs/{org_name}/products/{product_name}/devices/{identifier}/network_identities
openapi: 3.0.0
info:
  description: >
    The NervesCloud API gives users full access to their

    Orgs, Products, and corresponding Device fleets.


    The API can be used to integrate with your own systems, providing full
    access to your Product and Device data.


    The API is documented using the OpenAPI 3.0 specification.
  title: NervesCloud API
  version: 2.0.0
servers:
  - url: https://manage.nervescloud.com
    variables: {}
security:
  - bearer_auth: []
tags:
  - description: User authentication and API token creation
    name: Auth
  - description: Organization Certificate Authority management
    name: CA Certificates
  - description: >-
      Device management, including action requests eg. upgrade, reboot,
      reconnect
    name: Devices
  - description: Log lines Devices have sent over the logging extension
    name: Device Logs
  - description: >-
      Device management, including action requests eg. upgrade, reboot,
      reconnect
    name: Devices (short URL)
  - description: Device Certificate management
    name: Device Certificates
  - description: Identities a Device holds on networks NervesHub does not run
    name: Network Identities
  - description: Deployment Group and release management
    name: Deployment Groups
  - description: Firmware uploading and management
    name: Firmwares
  - description: Organization iroh endpoint id registration
    name: Iroh Endpoints
  - description: Organization management
    name: Organizations
  - description: Organization User membership management
    name: Organization Members
  - description: Product management
    name: Products
  - description: Organization Signing Key management
    name: Signing Keys
  - description: Product Support Script management
    name: Support Scripts
  - description: Platform healthcheck
    name: Platform Status
paths:
  /api/orgs/{org_name}/products/{product_name}/devices/{identifier}/network_identities:
    get:
      tags:
        - Network Identities
      summary: List the Network Identities a Device holds
      description: >
        The keys this device has reported holding on other networks — an iroh

        endpoint id, a NetBird, Tailscale or WireGuard public key.


        `service` is the protocol. `instance` names which endpoint of it, for a

        device running more than one — an iroh console and an iroh application,
        say.

        Anything running a single endpoint of a service uses `default`.
      operationId: NervesHubWeb.API.NetworkIdentityController.index
      parameters:
        - description: Organization Name
          example: example_org
          in: path
          name: org_name
          required: true
          schema:
            type: string
        - description: Product Name
          example: example_product
          in: path
          name: product_name
          required: true
          schema:
            type: string
        - description: Device Identifier
          example: example_device
          in: path
          name: identifier
          required: true
          schema:
            type: string
        - description: Only identities for this protocol
          example: iroh
          in: query
          name: service
          required: false
          schema:
            type: string
        - description: Only this endpoint of the protocol
          example: default
          in: query
          name: instance
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NetworkIdentityListResponse'
          description: Network Identity list response
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Forbidden
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ChangesetErrorResponse'
          description: Unknown service
      callbacks: {}
      security:
        - bearer_auth: []
components:
  schemas:
    NetworkIdentityListResponse:
      description: Network Identity list response
      example:
        data:
          - details:
              relay: https://relay.example.com
            identifier: c8924b6c9b7a8528b1365ebec4b2e43b6edebef684f8521f12b8caaf6e1b2302
            inserted_at: '2026-08-14T11:02:31Z'
            instance: default
            last_reported_at: '2026-08-16T09:14:00Z'
            service: iroh
            source: device_reported
            updated_at: '2026-08-16T09:14:00Z'
          - details: {}
            identifier: 5f691e39f55415be337b2e4cc0dd7291586ab7c4356bf32bab60f46fc78f95d5
            inserted_at: '2026-08-14T11:02:31Z'
            instance: console
            last_reported_at: '2026-08-16T09:14:00Z'
            service: iroh
            source: device_reported
            updated_at: '2026-08-16T09:14:00Z'
      properties:
        data:
          description: The identities this device holds
          items:
            $ref: '#/components/schemas/NetworkIdentity'
          type: array
      title: NetworkIdentityListResponse
      type: object
    ErrorResponse:
      description: Error response
      example:
        errors:
          detail: Resource Not Found or Authorization Insufficient
      properties:
        errors:
          properties:
            detail:
              type: string
          type: object
      title: ErrorResponse
      type: object
    ChangesetErrorResponse:
      description: Validation error response
      example:
        errors:
          identifier:
            - can't be blank
      properties:
        errors:
          additionalProperties:
            items:
              type: string
            type: array
          type: object
      title: ChangesetErrorResponse
      type: object
    NetworkIdentity:
      description: A key a device holds on a network NervesHub does not run
      example:
        details:
          relay: https://relay.example.com
        identifier: c8924b6c9b7a8528b1365ebec4b2e43b6edebef684f8521f12b8caaf6e1b2302
        inserted_at: '2026-08-14T11:02:31Z'
        instance: default
        last_reported_at: '2026-08-16T09:14:00Z'
        service: iroh
        source: device_reported
        updated_at: '2026-08-16T09:14:00Z'
      properties:
        details:
          additionalProperties: true
          description: >-
            Per-service and non-authoritative — relay urls, an assigned address.
            Never a secret
          type: object
        identifier:
          description: >-
            The value possession of which is proven — a public key, not a handle
            that can be reassigned
          type: string
        inserted_at:
          format: date-time
          type: string
        instance:
          description: >-
            Which endpoint of that protocol. `default` for anything running a
            single one
          type: string
        last_reported_at:
          format: date-time
          nullable: true
          type: string
        service:
          description: The protocol
          enum:
            - iroh
            - netbird
            - tailscale
            - wireguard
          type: string
        source:
          description: >-
            Whether anything proved this key. `device_reported` means a device
            did; `operator` means it was typed in
          enum:
            - device_reported
            - operator
          type: string
        updated_at:
          format: date-time
          type: string
      title: NetworkIdentity
      type: object
  securitySchemes:
    bearer_auth:
      scheme: bearer
      type: http

````