Get End-User Data

curl --request GET \
  --url https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/ \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
    "external_user_id": "end-user-123",
    "data": {
        "questions": [
            {
                "slug": "where-is-my-order",
                "question": "Where is my order?",
                "user_question": "where is my order",
                "content": "Your order shipped on...",
                "source": "WIDGET QUESTION",
                "date_created": "2026-08-01T09:12:44Z"
            }
        ],
        "rejected_questions": [],
        "conversations": [
            {
                "id": "1b9e86c9-87a8-472a-a6bf-6522e89b2de8",
                "date_created": "2026-08-01T09:12:40Z",
                "last_used": "2026-08-01T09:15:02Z"
            }
        ],
        "searches": [
            {
                "query": "how do I appeal a decision",
                "selected_labels": [],
                "date_created": "2026-08-01T09:10:11Z"
            }
        ],
        "profile": [
            {
                "profile_data": { "name": "Ada", "children": [{ "name": "Byron" }] },
                "created_at": "2026-07-02T11:00:00Z",
                "updated_at": "2026-08-01T09:10:11Z"
            }
        ],
        "memories": [
            { "memory": "Prefers to be contacted by email" }
        ],
        "page": {
            "limit": 100,
            "offset": 0,
            "has_more": {
                "questions": false,
                "rejected_questions": false,
                "conversations": false,
                "searches": false
            }
        }
    }
}

GET

{guru_slug}

end-users

{external_user_id}

data

Get End-User Data

curl --request GET \
  --url https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/ \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.gurubase.io/api/v1/{guru_slug}/end-users/{external_user_id}/data/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
    "external_user_id": "end-user-123",
    "data": {
        "questions": [
            {
                "slug": "where-is-my-order",
                "question": "Where is my order?",
                "user_question": "where is my order",
                "content": "Your order shipped on...",
                "source": "WIDGET QUESTION",
                "date_created": "2026-08-01T09:12:44Z"
            }
        ],
        "rejected_questions": [],
        "conversations": [
            {
                "id": "1b9e86c9-87a8-472a-a6bf-6522e89b2de8",
                "date_created": "2026-08-01T09:12:40Z",
                "last_used": "2026-08-01T09:15:02Z"
            }
        ],
        "searches": [
            {
                "query": "how do I appeal a decision",
                "selected_labels": [],
                "date_created": "2026-08-01T09:10:11Z"
            }
        ],
        "profile": [
            {
                "profile_data": { "name": "Ada", "children": [{ "name": "Byron" }] },
                "created_at": "2026-07-02T11:00:00Z",
                "updated_at": "2026-08-01T09:10:11Z"
            }
        ],
        "memories": [
            { "memory": "Prefers to be contacted by email" }
        ],
        "page": {
            "limit": 100,
            "offset": 0,
            "has_more": {
                "questions": false,
                "rejected_questions": false,
                "conversations": false,
                "searches": false
            }
        }
    }
}

People who reach your Guru through a widget, a chat bot or the API do not have a Gurubase account, so they cannot use the account tools to see or delete their data. This endpoint is how the team running the Guru answers their access (GDPR Art. 15) and erasure (Art. 17) requests. Which party is the controller for that data depends on your deployment and your agreement with us; see the privacy policy and your DPA rather than treating this page as the answer. Everything is scoped to the Guru in the path, so a key cannot reach another Guru’s data even for the same end-user id.

Path Parameters

string

required

The Guru the end user interacted with

string

required

The identifier your integration supplied when the questions were asked

Headers

string

required

Your API key. You can obtain one from the Gurubase dashboard.

Reading their data

GET returns their questions, the questions the Guru declined to answer, their conversations, their semantic searches, any stored profile, and any memories held about them. Results are paged. Each collection reports whether more remains, so keep raising offset until every has_more is false: an access response has to be complete, and stopping at the first page would understate what you hold. Memories come back on the first page only.

integer

default:"100"

Records per collection, per page. Maximum 1000.

integer

default:"0"

How many records to skip.

{
    "external_user_id": "end-user-123",
    "data": {
        "questions": [
            {
                "slug": "where-is-my-order",
                "question": "Where is my order?",
                "user_question": "where is my order",
                "content": "Your order shipped on...",
                "source": "WIDGET QUESTION",
                "date_created": "2026-08-01T09:12:44Z"
            }
        ],
        "rejected_questions": [],
        "conversations": [
            {
                "id": "1b9e86c9-87a8-472a-a6bf-6522e89b2de8",
                "date_created": "2026-08-01T09:12:40Z",
                "last_used": "2026-08-01T09:15:02Z"
            }
        ],
        "searches": [
            {
                "query": "how do I appeal a decision",
                "selected_labels": [],
                "date_created": "2026-08-01T09:10:11Z"
            }
        ],
        "profile": [
            {
                "profile_data": { "name": "Ada", "children": [{ "name": "Byron" }] },
                "created_at": "2026-07-02T11:00:00Z",
                "updated_at": "2026-08-01T09:10:11Z"
            }
        ],
        "memories": [
            { "memory": "Prefers to be contacted by email" }
        ],
        "page": {
            "limit": 100,
            "offset": 0,
            "has_more": {
                "questions": false,
                "rejected_questions": false,
                "conversations": false,
                "searches": false
            }
        }
    }
}

profile is not paged. There is at most one per person per Guru, and it is the most sensitive record here, so it is returned on every page rather than only the first. If the memory store cannot be read, the request fails with 500 rather than returning a partial copy. An access response that silently omits data understates what you hold, which is worse than an error you can retry. To erase the same person’s data, see Erase End-User Data.

API Documentation

Endpoints

Get End-User Data

Path Parameters

Headers

Reading their data

​Path Parameters

​Headers

​Reading their data

Path Parameters

Headers

Reading their data