---
title: "Add To Watchlist"
method: POST
path: "/v1/watchlist"
tags: ["watchlist"]
---

# Add To Watchlist

`POST /v1/watchlist`

Add a company or investor to the user's watchlist.

## Request body

- WatchlistItemIn
  - `entity_type` string, required — company or investor
  - `entity_code` string, required — Securities code or EDINET code
  - `entity_name` string, nullable — Display name

## Response `201`

Successful Response

- SingleResponseWatchlistItemOut
  - `data` WatchlistItemOut, required
    - `id` integer, required
    - `entity_type` string, required
    - `entity_code` string, required
    - `entity_name` string, nullable
    - `created_at` string, nullable
  - `meta` Meta, required
    - `total` integer, nullable — Total number of matching records (list endpoints only).
    - `limit` integer, nullable — Maximum records returned per page.
    - `offset` integer, nullable — Number of records skipped (offset-based pagination).
    - `next_cursor` string, nullable — Opaque cursor for the next page (keyset pagination). Null on the last page.
    - `request_id` string, required — Unique request identifier for tracing and support (e.g. 'req_abc123').

## Other responses

- `422` — Validation Error

## Changes

- **2026-03-31** `47575447accf` — 1 breaking, 2 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `201`
  - added the required property `data` to the response with the `201` status
  - added the required property `meta` to the response with the `201` status
- **2026-03-31** `debdd9fbc570` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/axioradev/apis/axiora-api/changes/v1/watchlist/post.md)

---

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