API Reference
Links
GET - List Links

List Links

GET Returns a list of all your links.

Request

Query Parameters

Pagination

NameTypeRequiredNotes
pageintegerfalseThe page number to request. Otherwise, the first page will be returned
per_pageintegerfalseThe number of items to return per page. Default: 15 Max: 30

Example

curl -L -X GET 'https://prettyurl.net/api/v1/links' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <API_KEY>'

Response

Schema

pagination

KeyTypeNotes
current_pageintegerThe current page
total_pagesintegerThe total number of pages
totalintegerThe total number of items across all pages
per_pageintegerThe number of items per page

links object

KeyType
idstring
titlestring
domainstring
groupobject
back_halfstring
short_linkstring
original_linkstring
updated_atdatetime
created_atdatetime

Example

{
    "status": "success",
    "message": "API request processed successfully.",
    "data": {
        "links": [
            {
                "id": string,
                "title": string,
                "domain": string,
                "group": {
                    "id": string,
                    "name": string,
                    "created_at": datetime
                },
                "back_half": string,
                "short_link": string,
                "original_link": string,
                "updated_at": datetime,
                "created_at": datetime
            }
        ],
        "pagination": {
            "current_page": number,
            "total_pages": number,
            "total": number,
            "per_page": number
        }
    }
}