usage

What this credential has been doing

Public API calls over a window, by day and by operation, plus the video time the account spent in the same window. A key sees only its own calls; a signed-in person sees the whole account. Windows are inclusive of from and exclusive of to, default the last 30 days, and may span at most 92.

get/usage

Request

  • Base URL: https://api.gogoscreen.com/api/v1
  • URL: https://api.gogoscreen.com/api/v1/usage
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Query parameters

fromstring date-time

The start of the window, inclusive. Defaults to 30 days ago.

tostring date-time

The end of the window, exclusive. Defaults to now.

groupBy'day' | 'operation' | 'both'

Which breakdowns to compute. both is the default.

Response

What this credential has been doing

fromstring date-time required
requestsnumber required

Every public call in the window, whatever it answered.

scope'api_key' | 'account' required

api_key when a key asked — it sees only its own calls.

secondsChargednumber nullable required

Video time charged in the window, from the wallet ledger — the only authority on spend. For a signed-in person this is the ACCOUNT's total. For a KEY it is the total of the work THAT KEY created: renders and marketing exports it started, joined to the ledger by the row they were charged against. Work started in the dashboard is not a key's, and one key never sees another's.

tostring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.