List Short Links
GETRetrieve a paginated list of short links created by the authenticated account.
List Short Links
GET /v1/links
Returns a paginated list of all short links owned by the authenticated account.
Query Parameters
▪
page *(integer, optional)*: Page offset (default: 1).▪
limit *(integer, optional)*: Maximum links to return per page (default: 20, max: 100).▪
status *(string, optional)*: Filter by lifecycle state (active, expired, all).Headers
| Header | Type | Description |
|---|---|---|
| Authorization | string | Bearer token with format `Bearer sh_live_...` |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-based index) |
| limit | integer | Number of items per page (max 100) |
| status | string | Filter by status: `active`, `expired`, `deleted`, or `all` |
Response Status Codes
| Code | Description |
|---|---|
| 200 | List of links retrieved successfully. |
| 401 | Missing or invalid API key. |
| 403 | Key lacks `links:read` scope. |
GET/v1/links
Scope: links:read
Server:
GEThttp://localhost:4000/v1/links?page=1&limit=20&status=active
Your API Key(In-Memory Only)
Get API KeyKeys entered here are held exclusively in volatile browser memory. They are never written to disk, cookies, or storage, and reset immediately upon page reload.
Query Parameters
pageinteger
limitinteger
statusstring
Click “Send Request” to execute a live test.