FinancialReports
  1. Watchlist
FinancialReports
  • FinancialReports API Documentation
  • Changelog
  • Python SDK
  • Companies
    • List Companies
      GET
    • Retrieve Company Details
      GET
  • Filings
    • List Filings
      GET
    • Retrieve Filing Details
      GET
    • Retrieve Filing Markdown
      GET
  • Filing Types
    • The Financial Reporting Classification Framework (FRCF)
    • List Filing Types
      GET
    • Retrieve Filing Type
      GET
  • Filing Categories
    • List Filing Categories
      GET
    • Retrieve Filing Category
      GET
  • Languages
    • Understanding Language Codes
    • List Languages
      GET
    • Retrieve Language
      GET
  • ISIC Classifications
    • Understanding ISIC Classification
    • List ISIC Classes
      GET
    • Retrieve ISIC Class
      GET
    • List ISIC Divisions
      GET
    • Retrieve ISIC Division
      GET
    • List ISIC Groups
      GET
    • Retrieve ISIC Group
      GET
    • List ISIC Sections
      GET
    • Retrieve ISIC Section
      GET
  • Countries
    • Understanding Country Codes
    • List Countries
    • Retrieve Country
  • Sources
    • Understanding Data Sources
    • List Data Sources
    • Retrieve Data Source
  • Watchlist
    • Get User's Watchlist
      GET
    • Add Company to Watchlist
      POST
    • Remove Company from Watchlist
      DELETE
  • Webhooks (Management)
    • List Webhooks
    • Create Webhook
    • Retrieve Webhook
    • Update Webhook
    • Partial Update Webhook
    • Delete Webhook
    • Regenerate Secret Key
    • Test Webhook
  • Schemas
    • Company
    • Language
    • Filing
    • Source
    • CompanyMinimal
    • Country
    • ErrorDetail
    • FilingType
    • DesignatedSponsor
    • FilingSummary
    • ISICClass
    • FilingProcessedPayload
    • FilingCategory
    • ISICDivision
    • ISICGroup
    • ISICSection
    • PaginatedFilingTypeList
    • PaginatedCompanyMinimalList
    • PaginatedFilingSummaryList
    • PaginatedISICClassList
    • PaginatedCountryList
    • PaginatedISICDivisionList
    • ListedStockExchange
    • PaginatedSourceList
    • PaginatedISICGroupList
    • PaginatedISICSectionList
    • PaginatedLanguageList
    • PaginatedFilingCategoryList
    • WatchlistAction
    • WatchlistCompany
    • WatchlistResponse
    • PaginatedWebhookList
    • PatchedWebhook
    • StockIndex
    • ProcessingStatusEnum
    • Webhook
    • WebhookCompanyPayload
    • WebhookFilingPayload
    • WebhookRegenerateSecret
  1. Watchlist

Add Company to Watchlist

POST
/watchlist/companies/
Access Level Required: Requires Standard Access (Level 1).

Adds a specified company to the authenticated user's watchlist.

Request

Header Params

Body Params application/json

Example
{
    "company_id": 14
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.financialreports.eu/watchlist/companies/' \
--header 'x-api-key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "company_id": 14
}'

Responses

🟢201Created
application/json
Company successfully added to the watchlist.
Body

Example
{
    "status": "success",
    "message": "Company added to watchlist.",
    "company_id": 14
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2026-02-03 14:14:34
Previous
Get User's Watchlist
Next
Remove Company from Watchlist
Built with