FinancialReports
  1. Watchlist
FinancialReports
  • FinancialReports API Documentation
  • Companies
    • List Companies
      GET
    • Retrieve Company Details
      GET
  • Filings
    • List Filings
      GET
    • Retrieve Filing Details
      GET
  • Processed Filings
    • Retrieve Processed Filing Content
      GET
  • Filing Types
    • List Filing Types
      GET
    • Retrieve Filing Type
      GET
  • GICS Classifications
    • List GICS Sectors
      GET
    • List GICS Industry Groups
      GET
    • List GICS Industries
      GET
    • List GICS Sub-Industries
      GET
    • Retrieve GICS Sector
      GET
    • Retrieve GICS Industry Group
      GET
    • Retrieve GICS Industry
      GET
    • Retrieve GICS Sub-Industry
      GET
  • Sources
    • List Data Sources
      GET
    • Retrieve Data Source
      GET
  • Watchlist
    • Get User's Watchlist
      GET
    • Add Company to Watchlist
      POST
    • Remove Company from Watchlist
      DELETE
  • schema
    • schema_retrieve
      GET
  1. Watchlist

Add Company to Watchlist

POST
/watchlist/companies/
Watchlist
Adds a specified company to the authenticated user's watchlist. The company_id must be provided in the request body.

Request

Header Params
x-api-key
string 
required
Body Params application/x-www-form-urlencoded
company_id
integer 
required
The unique identifier of the company to add or remove from the watchlist.

Request 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;' \
--data-urlencode 'company_id='

Responses

🟢201Created
application/json
Company successfully added to the watchlist.
Body
status
string 
required
Indicates the status of the operation (e.g., 'success', 'error').
message
string 
required
A human-readable message describing the outcome.
company_id
integer 
optional
The ID of the company related to the action, if applicable.
Example
{
    "status": "string",
    "message": "string",
    "company_id": 0
}
🟠400Bad Request
🟠401Unauthorized
Modified at 2025-05-24 05:59:30
Previous
Get User's Watchlist
Next
Remove Company from Watchlist
Built with