List & Get Links

List All Links

GET /api/v1/links

Returns a paginated list of all your short links.

Query Parameters

Param	Type	Default	Description
`page`	`number`	`1`	Page number
`limit`	`number`	`20`	Items per page (max 100)
`search`	`string`	—	Filter by short code or title

Response

200 OK

json

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "short_code": "my-code",
      "short_url": "https://shrinkr.nl/my-code",
      "original_url": "https://example.com",
      "title": "My Link",
      "click_count": 42,
      "is_active": true,
      "created_at": "2026-03-01T12:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 5,
    "total_pages": 1
  }
}

Example

bash

curl https://shrinkr.nl/api/v1/links?page=1&limit=10 \
  -H "Authorization: Bearer sk_shrinkr_a1b2c3d4e5f6g7h8i9j0k1l2"

Get a Specific Link

GET /api/v1/links/:code

Get details for a specific link by its short code.

Response

200 OK

json

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "short_code": "my-code",
  "short_url": "https://shrinkr.nl/my-code",
  "original_url": "https://example.com",
  "title": "My Link",
  "click_count": 42,
  "is_active": true,
  "created_at": "2026-03-01T12:00:00Z",
  "updated_at": "2026-03-01T14:30:00Z"
}

Errors

Code	Description
`401`	Missing or invalid authentication
`404`	Link not found or doesn't belong to you

Example

bash

curl https://shrinkr.nl/api/v1/links/my-code \
  -H "Authorization: Bearer sk_shrinkr_a1b2c3d4e5f6g7h8i9j0k1l2"

Create Link

Delete Link