---
title: "List owned links with explicit pagination"
method: GET
path: "/links"
tags: ["Account"]
---

# List owned links with explicit pagination

`GET /links`

## Request

- Base URL: `https://tier1.shop/wp-json/tier1-api/v1`
- URL: `https://tier1.shop/wp-json/tier1-api/v1/links`
- Auth: HTTP bearer

## Query parameters

- `geo` 'ru' | 'intl' | 'all'
- `status` string
- `link_type` 'yearly' | 'onetime' | 'through' | 'replacement' | 'renewal_yearly' | 'renewal_through'
- `page` integer
- `per_page` integer

## Response `200`

Owned links and pagination

- PagedLinks
  - `page` integer, required
  - `per_page` integer, required
  - `total` integer, required
  - `pages` integer, required
  - `has_more` boolean, required
  - `next_page` integer, nullable, required
  - `links` Link[]
    - `id` integer, required
    - `order_id` integer, required: cabinet_order_id
    - `geo` string
    - `url` string, nullable
    - `link_type` string
    - `placement_years` integer, nullable
    - `anchor` string, nullable
    - `context_text` string, nullable
    - `donor_url` string, nullable
    - `screenshot_url` string, nullable
    - `status` string, required
    - `scheduled_at` string, nullable
    - `deadline_at` string, nullable
    - `placed_at` string, nullable
    - `expires_at` string, nullable
    - `created_at` string

## Other responses

- `4XX`: Safe API error. Unknown and foreign resources have the same generic 404.

---

[API](https://skmtc.dev/tier1/apis/tier1-shop-client-api.md) · [All operations](https://skmtc.dev/tier1/apis/tier1-shop-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tier1/apis/tier1-shop-client-api/revisions/6865b273f97a?raw)