---
title: "Get resource links"
method: GET
path: "/api/v1/resource-links"
tags: ["Resource Links"]
---

# Get resource links

`GET /api/v1/resource-links`

Each device publishes links to its resources to the plgd hub. Authorized user can get all published links in form of a stream, chunk by chunk. Attach your reader and consume link by link. Various filters allows you to be more concrete in links you would like to get. Error response might be returned immediately, but also anytime during the stream reading.

## Query parameters

- `deviceId` string, uuid
- `type` string[]

## Response `200`

Stream of resource links or errors.

- object
  - `result` ResourceLinks
    - `resources` ResourceLink[]
      - `href` string
      - `deviceId` string
      - `resourceTypes` string[]
      - `interfaces` string[]
      - `anchor` string
      - `title` string
      - `supportedContentTypes` string[]
      - `validUntil` string, int64
      - `policy` object
        - `bitFlags` integer
      - `endpointInformations` object[]
        - `endpoint` string
        - `priority` string, int64
    - `deviceId` string
    - `auditContext` AuditContext
      - `userId` string
      - `correlationId` string
    - `eventMetadata` EventMetadata
      - `version` string, uint64
      - `timestamp` string, int64
      - `connectionId` string
      - `sequence` string, uint64
  - `error` Error
    - `code` integer
    - `message` string
    - `details` object[]
      - `typeUrl` string
      - `value` string, byte

## Other responses

- `400` — Bad Request
- `401` — Not authorized

---

[API](https://skmtc.net/plgd-dev/apis/plgd-http-gateway.md) · [All operations](https://skmtc.net/plgd-dev/apis/plgd-http-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/plgd-dev/plgd-http-gateway/versions/bbfd9fa43407/schema)