---
title: "ウォッチリストに追加"
method: POST
path: "/watchlist"
tags: ["Watchlist"]
---

# ウォッチリストに追加

`POST /watchlist`

## Request

- Base URL: `https://edinetdb.jp/v1`
- URL: `https://edinetdb.jp/v1/watchlist`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

企業をウォッチリストに追加。最大登録数を超えると429。
edinet_code は登録時に実在検証され、当データベースに存在しないコードは保存されず404を返す。
検証自体が一時的に実行できない場合は503（「存在しない」とは区別される）。

## Request body

- object
  - `edinet_code` string, required
  - `label` string: カスタムラベル（20文字まで）

## Response `200`

追加成功

## Other responses

- `400`: edinet_code 未指定
- `404`: 指定された edinet_code が当データベースに存在しない（保存されない）
- `429`: 登録上限到達
- `503`: 企業の実在検証が一時的に利用できない（リトライ可）

---

[API](https://skmtc.dev/edinetdb/apis/edinet-db-api.md) · [All operations](https://skmtc.dev/edinetdb/apis/edinet-db-api/llms.txt) · [OpenAPI document](https://skmtc.dev/edinetdb/apis/edinet-db-api/revisions/d896c5f7d472?raw)
