WIwistia
Account

Get Account Usage

Changed on

Retrieves plan, usage, and limit information for the current account.

The response includes plan tier, upload eligibility, and links to billing pages. Usage and limit details (media counts, storage, seats, bandwidth) are only visible to account owners and managers — other contacts receive null for the limits field.

Requires api token with one of the following permissions

(any scope allowed)

Tokens with the "Act with a team member's permissions" permission (all:delegate_to_contact_permissions scope) can also be used. Requests made with such a token are authorized using the permissions of the contact assigned to the token.

Expiring access tokens created with authorizations cannot be used: this endpoint responds with a 403, whatever the authorizations grant.

get/account_usage

Request

  • Base URL
    https://api.wistia.com/modern
  • URL
    https://api.wistia.com/modern/account_usage
  • Auth
    HTTP bearer

Headers

X-Wistia-API-Versionstring required

Response

Successful response

can_uploadboolean required

Whether the next upload will succeed. False when an inflexible media or storage limit has been reached.

upload_blocked_reasonstring nullable required

The reason uploads are blocked, or null if uploads are allowed. Known values: reached_media_limit, reached_storage_limit.

rolestring nullable required

The authenticated contact's role on the account. One of owner, manager, standard_user, limited_user, viewer. Null when the token isn't associated with a specific contact.

verified_domainboolean required

Whether the account has at least one verified business domain (i.e. an owner whose email domain is verified and business-classified). Independent of plan tier.

can_invite_teammatesboolean required

Whether the authenticated contact can invite additional teammates via the modern contacts endpoint. True when the contact is an owner or manager and the account has a verified business domain.

Changes