Skip to main content
GET
/
profiles
TypeScript
import { DiscovrClient } from "discovr";
import type { GetProfilesResponse } from "discovr";

const discovr = new DiscovrClient("your-client-id", {
  basePath: "https://api.discovr.media",
});

// After sign-in and profile selection …
const response: GetProfilesResponse = await discovr.getProfiles();
console.log(response);
{
  "profiles": [
    {
      "id": "profile_abc123xyz",
      "name": "Sci-Fi Lover",
      "avatarUrl": "https://example.com/avatar.jpg",
      "createdAt": "2023-01-01T00:00:00.000Z"
    },
    {
      "id": "profile_def456uvw",
      "name": "Action Movie Fan",
      "avatarUrl": "https://example.com/avatar2.jpg",
      "createdAt": "2023-01-02T00:00:00.000Z"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.discovr.media/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer token authentication.

  • Identity-tier endpoints (/profiles, /auth/session-token, /auth/session) accept a long-lived refresh token (rt_<hex>).
  • Session-tier endpoints (/pages/*, /profile/*) accept a short-lived session JWT.

SDK clients use two typed API accessors (identityApi() with the refresh token vs sessionApi() with the session JWT) — see the SDK DiscovrAuth helper.

Format: Authorization: Bearer {token}

Response

Profiles returned successfully

List of profiles for the signed-in user.

​
profiles
object[]
required

Profiles for the signed-in user, ordered by creation date (newest first).

Example:
[
  {
    "id": "profile_abc123xyz",
    "name": "Sci-Fi Lover",
    "avatarUrl": "https://example.com/avatar.jpg",
    "createdAt": "2023-01-01T00:00:00.000Z"
  },
  {
    "id": "profile_def456uvw",
    "name": "Action Movie Fan",
    "avatarUrl": "https://example.com/avatar2.jpg",
    "createdAt": "2023-01-02T00:00:00.000Z"
  }
]