Watchlists

Beta. PUT /v1/watchlists/{watchlist_id} is a complete replacement for one account-scoped watchlist. It is idempotent.

Planned base: https://api.telltale.actuans.com. Not live. Bearer token required.

Members

Members may be UEN or name inputs, the same shapes as resolve.

Ambiguous and unknown inputs are retained as explicit unresolved members. They do not count as watched companies and are never silently mapped to an arbitrary UEN.

PUT /v1/watchlists/portfolio
Authorization: Bearer <api_token>
Content-Type: application/json

{
  "members": [
    {"uen":"12345678A"},
    {"name":"EXAMPLE PTE. LTD."}
  ]
}

watchlist_id may contain only letters, digits, hyphen, or underscore (1–120 characters).

Free limit

The successful 200 response reports each member’s retained resolution, account_watched_company_count, and free_company_limit.

The Free Core public limit is exactly 25 distinct resolved companies per account:

• 24 → 25 succeeds
• exactly 25 succeeds
• a replacement that would contain 26 distinct resolved companies fails with HTTP 409 and error.code: "watchlist_limit_exceeded"
• an existing watchlist is not changed by a rejected replacement
• the limit is the account union, so another watchlist ID cannot bypass it

Unresolved members do not count toward the 25.

Reads require a watched company

Observation, history, and company-change reads require the canonical company to be a resolved member of one of the authenticated account’s watchlists. An unwatched company returns HTTP 403 with error.code: "company_not_watched".