---
title: "Tamloot — Get a session"
description: "Get a session: parameters, request examples, and response schemas for GET /v1/sessions/{session_id}."
canonical: "https://tamloot.cc/en/docs/developers/api-reference/get-session"
last-updated: "2026-10-18"
---

# Get a session

`GET /v1/sessions/{session_id}`

Send your API key in the `Authorization: Bearer $TAMLOOT_API_KEY` header. Only data visible to the key owner is accessible.

Based on the published [OpenAPI description](https://tamloot.cc/openapi.json). Schema names and code identifiers are shown exactly as the API defines them.

## Parameters

| Parameter | Location | Required | Type | Constraints |
| --- | --- | --- | --- | --- |
| `session_id` | path | Yes | string (uuid) | — |

## Request examples

```bash
curl "https://api.tamloot.cc/v1/sessions/00000000-0000-4000-8000-000000000000" \
  --header "Authorization: Bearer $TAMLOOT_API_KEY"
```

```javascript
const response = await fetch("https://api.tamloot.cc/v1/sessions/00000000-0000-4000-8000-000000000000", {
  headers: { Authorization: `Bearer ${process.env.TAMLOOT_API_KEY}` },
});
if (!response.ok) throw new Error('HTTP ' + response.status);
const result = await response.json();
```

## Responses

| Status | Meaning |
| --- | --- |
| 200 | Successful response |
| 401 | Missing or invalid API key |
| 404 | Record not found or not visible to this account |
| 422 | Invalid request parameters |
| 429 | Rate limit exceeded; wait according to Retry-After |

### Success response schema

```json
{
  "type": "object",
  "properties": {
    "data": {
      "allOf": [
        {
          "type": "object",
          "properties": {
            "id": {
              "type": "string",
              "format": "uuid"
            },
            "title": {
              "type": "string",
              "nullable": true
            },
            "subtitle": {
              "type": "string",
              "nullable": true
            },
            "session_date": {
              "type": "string",
              "format": "date-time",
              "nullable": true
            },
            "session_date_end": {
              "type": "string",
              "format": "date-time",
              "nullable": true
            },
            "recording_status": {
              "type": "string",
              "nullable": true
            },
            "source": {
              "type": "string",
              "nullable": true
            },
            "conference_provider": {
              "type": "string",
              "nullable": true
            },
            "client": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "full_name": {
                  "type": "string",
                  "nullable": true
                }
              },
              "nullable": true
            }
          }
        },
        {
          "type": "object",
          "properties": {
            "conference_url": {
              "type": "string",
              "nullable": true
            },
            "google_doc_url": {
              "type": "string",
              "nullable": true
            },
            "created_at": {
              "type": "string",
              "format": "date-time"
            },
            "updated_at": {
              "type": "string",
              "format": "date-time"
            },
            "notes": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string",
                    "nullable": true
                  },
                  "title_slug": {
                    "type": "string",
                    "nullable": true
                  },
                  "content": {
                    "type": "string",
                    "nullable": true
                  },
                  "position": {
                    "type": "integer"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "user_manual",
                      "ai_meeting_prep",
                      "user_template",
                      "ai_predefined",
                      "ai_assistant",
                      "reader_comment"
                    ],
                    "description": "reader_comment: a note a colleague who reads the session added"
                  }
                }
              }
            },
            "client": {
              "type": "object",
              "nullable": true,
              "properties": {
                "id": {
                  "type": "string",
                  "format": "uuid"
                },
                "full_name": {
                  "type": "string",
                  "nullable": true
                },
                "email": {
                  "type": "string",
                  "nullable": true
                }
              }
            }
          }
        }
      ]
    }
  }
}
```

### Error response schema

```json
{
  "type": "object",
  "required": [
    "error"
  ],
  "properties": {
    "error": {
      "type": "object",
      "required": [
        "code",
        "message"
      ],
      "properties": {
        "code": {
          "type": "string",
          "description": "HTTP status code as a string, e.g. \"404\""
        },
        "message": {
          "type": "string"
        }
      }
    }
  }
}
```

### Response headers

```json
{
  "RateLimit-Limit": {
    "description": "Requests allowed per one-second window.",
    "schema": {
      "type": "integer"
    }
  },
  "RateLimit-Policy": {
    "description": "The rate-limit policy, as `<limit>;w=<window seconds>`.",
    "schema": {
      "type": "string"
    }
  }
}
```

See the [quickstart](/en/docs/developers/quickstart) for API key setup and [API overview](/en/docs/developers/api) for rate limits and versioning.

## Where to look next

- [Tamloot](https://tamloot.cc/en)
- [All guides](https://tamloot.cc/en/docs)
- [llms.txt](https://tamloot.cc/docs/llms.txt)
- [Sitemap](https://tamloot.cc/sitemaps/sitemap.xml)