Skip to main content
POST
/
{guru_slug}
/
sessions
/
List Sessions
curl --request POST \
  --url https://api.gurubase.io/api/v1/{guru_slug}/sessions/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "page_num": 123,
  "search_query": "<string>",
  "external_user_id": "<string>"
}
'
{
    "today": [
      {
        "last_used": "2025-07-29T10:23:27.535170Z",
        "id": "0389210e-720d-442c-8fd4-2c6ecda89627",
        "guru_type_slug": "gurubase",
        "guru_type_name": "Gurubase",
        "root_question_name": "What is Gurubase?",
        "root_question_slug": "what-is-gurubase-73d46ea7-12b5-49c7-ab5e-1dffdb8b71de-69e06b42-d549-4624-8400-768f7388361a",
        "root_question_link": "<link_to_the_question>"
      }
    ],
    "last_week": [
      {
        "last_used": "2025-07-28T16:05:10.579616Z",
        "id": "25dffa55-b947-41af-9bca-a2361afca8be",
        "guru_type_slug": "gurubase",
        "guru_type_name": "Gurubase",
        "root_question_name": "Does Gurubase support Slack ?",
        "root_question_slug": "does-gurubase-support-slack-64911f4a-03c7-4105-a477-80d68f030dfe",
        "root_question_link": "<link_to_the_question>"
      }
    ],
    "older": [],
    "has_more": false
}
Retrieve conversation sessions for a specific Guru. This endpoint supports pagination and search functionality, returning sessions grouped by time periods.

​
Path Parameters

​
guru_slug
string
required
The slug of the Guru to retrieve sessions for

​
Headers

​
x-api-key
string
required
Your API key for authentication. You can obtain your API key from the Gurubase dashboard.

​
Body Parameters

​
page_num
integer
default:1
The page number for pagination. Must be a positive integer.
​
search_query
string
default:""
Search query to filter sessions. Searches across question text, user questions, and session slugs.
​
external_user_id
string
Filter sessions by external user ID. When provided, only returns sessions associated with this external user ID.

​
Response

​
today
array
Sessions from today
​
last_week
array
Sessions from the last 7 days (excluding today)
​
older
array
Sessions older than 7 days
​
has_more
boolean
Whether there are more sessions available beyond the current page
{
    "today": [
      {
        "last_used": "2025-07-29T10:23:27.535170Z",
        "id": "0389210e-720d-442c-8fd4-2c6ecda89627",
        "guru_type_slug": "gurubase",
        "guru_type_name": "Gurubase",
        "root_question_name": "What is Gurubase?",
        "root_question_slug": "what-is-gurubase-73d46ea7-12b5-49c7-ab5e-1dffdb8b71de-69e06b42-d549-4624-8400-768f7388361a",
        "root_question_link": "<link_to_the_question>"
      }
    ],
    "last_week": [
      {
        "last_used": "2025-07-28T16:05:10.579616Z",
        "id": "25dffa55-b947-41af-9bca-a2361afca8be",
        "guru_type_slug": "gurubase",
        "guru_type_name": "Gurubase",
        "root_question_name": "Does Gurubase support Slack ?",
        "root_question_slug": "does-gurubase-support-slack-64911f4a-03c7-4105-a477-80d68f030dfe",
        "root_question_link": "<link_to_the_question>"
      }
    ],
    "older": [],
    "has_more": false
}