WATCH COMPANIES / API REFERENCE

Add watched fields

Add indicators to an existing watch subscription.

PUT/companies/{id}/watch/fields/addOfficial reference

Parameters

idpath · integerRequired

Company ID returned by a company lookup. It is not the registration number.

fieldsbody · string[]Optional

Watch indicator keys, such as company.status or company.financial.

Response

200 · application/json

Illustrative returned field list. Confirm exact behavior and accepted indicator keys before integration.

[
  "company.financial"
]

Request example

curl --fail-with-body --request PUT 'https://api.globaldatabase.com/v2/companies/YOUR_COMPANY_ID/watch/fields/add' \
  --header "Authorization: Token $GDB_API_KEY" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "fields": [
    "company.status"
  ]
}'

Set GDB_API_KEY in your server environment. Replace YOUR_COMPANY_ID with the ID returned by your lookup. These examples are not executed by this page.