---
title: "Get events by user_id"
method: POST
path: "/v2beta/track/event/get"
tags: ["Event"]
---

# Get events by user_id

`POST /v2beta/track/event/get`

## Request

- Base URL: `https://api.karte.io`
- URL: `https://api.karte.io/v2beta/track/event/get`
- Auth: HTTP bearer

ユーザーごとに記録されたイベントを取得します。
- このAPIは強整合性をサポートしていません。強整合性については以下のページをご確認ください。
  - [ユーザー解析における「強整合性」について | スタートガイド / KARTE基礎知識・仕様 / イベントの仕様 | KARTEサポートサイト](https://support.karte.io/post/l9sqplRlHKO1bpM6fpgyt)

#### Required Scope
APIの実行に必要なScopeです。
```
beta.track.event.get
```

#### Required Role
管理画面でScopeを追加する際に必要な権限です。
```
基本機能 > 基本機能作成・編集
```

## Headers

- `x-karte-api` string
- `authorization` string
- `content-type` string

## Request body

- object
  - `user_id` string, required: 特定のユーザーを識別するキー メンバーの情報を取得する場合は当該メンバーの user_id を指定します。 ビジターの情報を取得する場合は visitor_id( `vis-xxxxxxxxxx` の形式) をこのプロパティの引数に指定します。
  - `event_names` string[], required: 取得したいイベントの名前をリスト形式で指定します。 最大10個のイベント名を指定することができます。
  - `options` object, nullable
    - `limit` integer: 取得結果の件数を指定します。 指定されていない場合は10件のイベントを返却します。 ※ Beta期間中は最大10件に制限しております。
    - `from` number: 指定された時刻以降のイベントデータを取得します。 形式はunix time (ミリ秒) で13桁の値となります。 e.g. 2019年06月08日 22:20:00 の場合は 1560000000000 を指定します。
    - `to` number: 指定された時刻より前のイベントデータを取得します。 形式はunix time (ミリ秒) で13桁の値となります。 e.g. 2019年06月08日 22:20:00 の場合は 1560000000000 を指定します。

## Response `200`

A successful response.

- object
  - `events` object: リクエストで指定した event_name ごとにイベント情報が格納されます。イベントは時刻（ `_date` ）の昇順で格納されます。 e.g. view と buy のイベントを指定した場合、以下のような形式で返却されます。 ``` events: { view: [ { event_hash: xxxx ... }, { event_hash: yyyy ... } ... ] buy: [ { event_hash: aaaa ... }, { event_hash: bbbb ... } ... ] } ``` ただしリクエストで指定した user_id が存在しない場合は空のeventsが返却されます。 e.g. ``` events: {} ```

## Other responses

- `422`: APIのイベント送信数の上限に達した場合

---

[API](https://skmtc.dev/karte/apis/insight.md) - [All operations](https://skmtc.dev/karte/apis/insight/llms.txt) - [OpenAPI document](https://skmtc.dev/karte/apis/insight/revisions/0081a93c4d1d?raw)