---
title: "Get a list of related Links for a news story"
method: GET
path: "/batch/{batch_id}/news/{id}/link"
tags: ["news", "links"]
---

# Get a list of related Links for a news story

`GET /batch/{batch_id}/news/{id}/link`

## Request

- Base URL: `https://submitapi.dvidshub.net`
- URL: `https://submitapi.dvidshub.net/batch/{batch_id}/news/{id}/link`
- Auth: OAuth 2
  - Authorization code: `https://api.dvidshub.net/auth/authorize`
  - Token URL: `https://api.dvidshub.net/auth/access_token` scopes: `basic`, `email`, `upload`
- TypeScript: <https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/docs/batch/:batch_id/news/:id/link/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the related Links associated with a specific news story in a batch.

## Response `200`

An array of Link objects

- object
  - `data` object, required: Represents a URL with a descriptive title
    - `id` string, required
    - `type` 'link', required
    - `attributes` object, required
      - `title` string: Descriptive text for this link
      - `url` string, url: The URL must use HTTPS protocol and have a TLD that ends in .mil, .gov, or dvidshub.net

## Other responses

- `403`: Access is denied to the requested resource.
- `404`: The object identified by path parameters does not exist.

---

[API](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api.md) - [All operations](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dvidshub/apis/dvids-content-submission-api/revisions/921b385ab6b9?raw)
