List library items - Hasta Backend

Request: query params; Bearer token optional

Returns published library items, paginated and sorted alphabetically by title. Filter by a single content_type, or search by title. When content_type is omitted / empty / all, items of every content type are returned.

Auth is optional: when a valid token is sent, each item's is_saved reflects whether the signed-in user has favourited it; anonymously is_saved is always false.

This is the minimal list shape (title, slug, content_type, source_name, audio_url, is_premium, is_saved); fetch GET /library/{slug} for the full item.

Query: page_number (default 1), content_type (optional - one type or all), search (optional - title match)

Success: 200 - data.items[] + total, offset, limit.

Errors: none - public endpoint

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Library fetched successfully",
    "data": {
        "items": [
            {
                "title": "Samudra Manthan: The Churning of the Cosmic Ocean",
                "slug": "samudra-manthan-the-churning-of-the-cosmic-ocean",
                "short_description": "The devas and asuras \n                        churn the ocean for the nectar of immortality.",
                "content_type": "puranic_story",
                "source_name": "Vishnu Purana",
                "audio_url": "https://audio.hastaai.in/audio/library/abc123",
                "is_premium": false,
                "is_saved": false,
                "has_reminder": false
            }
        ],
        "total": 185,
        "offset": 0,
        "limit": 10
    }
}

🟠422Parameter Error