Signal API

Get covered follower costs

Changed on

Returns what the signal provider paid for each of its followers, per month. Only applies when the signal provider covers follower costs; otherwise the result is empty. Followers that cost nothing, for example because they exceed the per-project cap, are not listed. If month and year are not provided, all months are returned.

get/rest/api/v1/signals/{signalProviderId}/followerCosts

Request

Path parameters

signalProviderIdstring uuid required

Query parameters

monthinteger

Month (1-12). If omitted, returns all months.

yearinteger

Year (e.g. 2026). If omitted, returns all years.

Response

OK

coverFollowerCostsboolean

Whether this signal provider currently covers the costs of its followers. If false, no costs are reported.

currencystring

Currency of all monetary amounts

signalProviderIdstring uuid

UUID of the signal provider feature

signalProviderNamestring

Display name of the signal provider

totalCostnumber

Total covered follower costs across all reported months

Example response

{
  "months": [
    {
      "month": 9,
      "year": 2026
    }
  ]
}

Changes