---
title: "List Link Validations"
method: GET
path: "/v1/inspect/links"
tags: ["Link Validation"]
---

# List Link Validations

`GET /v1/inspect/links`

## Request

- Base URL: `https://api.mailgun.net`
- URL: `https://api.mailgun.net/v1/inspect/links`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/mailgun/apis/email-preview-api/docs/v1/inspect/links/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a list of previous link validation tests based on various filters.

## Query parameters

- `status` string
- `id` string
- `url` string
- `isExpiredSSL` string
- `statusCode` integer

## Response `200`

A 200 response

- GithubComMailgunInspectInternalLinkvalidationGetLinkValidationTestsJSONAPIResponse
  - `meta` object, nullable
  - `paging` GithubComMailgunScaffoldHttpapiPagingPagingResponse
    - `previous` string, required: Previous page URL
    - `first` string, required: First page URL
    - `next` string, required: Next page URL
    - `last` string, required: Last page URL
  - `items` GithubComMailgunInspectInternalLinkvalidationLinkValidation[]
    - `id` string, required
    - `links` GithubComMailgunInspectInternalLinkvalidationSelfLink
      - `self` string, required
    - `results` GithubComMailgunInspectInternalLinkvalidationLinkValidationResult[]
      - `url` string, required
      - `status` string, required
      - `status_code` integer
      - `line` integer
      - `column` integer
      - `selector` string
      - `absolute_index` integer
      - `passes` GithubComMailgunInspectInternalLinkvalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `failures` GithubComMailgunInspectInternalLinkvalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required
      - `informational` GithubComMailgunInspectInternalLinkvalidationRuleEvaluation[]
        - `id` string, required
        - `rule` string, required
        - `description` string, required
        - `impact` string
        - `recommendation` string
        - `details` object[], required

## Other responses

- `400`: A 400 response
- `401`: A 401 response

---

[API](https://skmtc.dev/mailgun/apis/email-preview-api.md) - [All operations](https://skmtc.dev/mailgun/apis/email-preview-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mailgun/apis/email-preview-api/revisions/c8a18f02bc8b?raw)