---
title: "Get session"
method: GET
path: "/api/sessions"
tags: ["Session"]
---

# Get session

`GET /api/sessions`

Retrieves information from a previously created sesssion.


>⚠️ The Session Manager API uses the `vtex_session` and `vtex_segment` cookies to store the data required to identify the user and the session. These cookies are stored in the user's browser when the session is created and sent automatically in every request to that domain. You will have to reproduce that by sending these cookies as headers to Session Manager API in order for it to work outside of a browser environment.

## Permissions

This endpoint does not require [authentication](https://developers.vtex.com/docs/guides/authentication) or [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).

## Query parameters

- `items` string, required

## Response `200`

OK

- GetSessionResponse — Session information.
  - `id` string — Session ID.
  - `namespaces` object — Object with namespaces, each containing a set of information about the session.
    - `account` object — Account information related to the session.
      - `id` object — VTEX account ID.
        - `value` string — Value of the VTEX account ID.
        - `keepAlive` boolean — Determines whether or not the connection should be kept alive.
      - `accountName` object — VTEX account name.
        - `value` string — Value of the VTEX account name.
    - `store` object — Store information related to the session.
      - `channel` object — [Trade policy](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV) ID.
        - `value` string — Value of the [Trade policy](https://help.vtex.com/en/tutorial/how-trade-policies-work--6Xef8PZiFm40kg2STrMkMV) ID.
      - `countryCode` object — Country code.
        - `value` string — Value of the country code.
      - `cultureInfo` object — Locale that provides culture-specific information, such as the language, sublanguage, country/region, calendar, and conventions associated with a particular culture. Read [this documentation](https://learn.microsoft.com/en-us/dotnet/api/system.globalization.cultureinfo?view=net-7.0#culture-names-and-identifiers) for more details.
        - `value` string — Value of the `cultureInfo` property.
      - `currencyCode` object — Currency code.
        - `value` string — Value of the currency code.
      - `currencySymbol` object — Currency symbol.
        - `value` string — Value of the currency symbol.
      - `channelPrivacy` object — Defines whether or not the channel is private.
        - `value` string — Value containing the channel's privacy option.
    - `public` object — Public and editable information related to the session.
    - `checkout` object — Checkout information related to the session.
      - `regionId` object — ID of the session's region.
        - `value` string — Value of the Region ID.

## Changes

- **2023-08-24** `28855b35a98d` — 2 info
  - api tag `Session` added
  - api tag `Sessions` removed
- **2023-08-24** `071ca65af878` — 1 info
  - added the media type `application/json` for the response with the status `200`
- **2023-08-24** `40a672c7c638` — 1 info
  - the endpoint scheme security `vtex_session AND vtex_segment` was added to the API
- **2023-03-06** `37d29cfb77a1` — 1 info
  - endpoint added
- **2019-12-20** `2d1981d5f092` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/vtex/apis/session-manager-api/changes/api/sessions/get.md)

---

[API](https://skmtc.dev/vtex/apis/session-manager-api.md) · [All operations](https://skmtc.dev/vtex/apis/session-manager-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vtex/session-manager-api/revisions/f4f1f2686364/schema)