---
title: "GET /v1/events/{endpoint_name}"
method: GET
path: "/v1/events/{endpoint_name}"
tags: ["endpoint"]
---

# GET /v1/events/{endpoint_name}

`GET /v1/events/{endpoint_name}`

## Request

- Base URL: `https://api.octoai.cloud`
- URL: `https://api.octoai.cloud/v1/events/{endpoint_name}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/octoml/apis/octoai-api/docs/v1/events/:endpoint_name/get.ts> (a function with typed inputs; its response is checked against the schema)

Return endpoint events

## Path parameters

- `endpoint_name` string, required

## Query parameters

- `begin_time` string, date-time
- `end_time` string, date-time
- `max_lines` integer
- `replica_id` string

## Response `200`

A set of events associated with the endpoint

- EventEntry[]
  - `timestamp` string, date-time, required: time of the log entry (ISO8601 format)
  - `replica_id` string: optional replica id associated with the event
  - `event` Event, required
    - `level` 'normal' | 'warning': type of event
    - `type` string, required: type of the event
    - `endpoint` string: name of the endpoint
    - `tenant_id` string: ID of the tenant
    - `account_key` string: Key of the account
    - `instance_type` string: type of instance this event occurred on
    - `details` object: extra details about this event

---

[API](https://skmtc.dev/octoml/apis/octoai-api.md) - [All operations](https://skmtc.dev/octoml/apis/octoai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octoml/apis/octoai-api/revisions/ff4ad53097bc?raw)