Show the calling account
/api/v1/account
operationId: account.show
Base: https://portal.watcheye.com.au/api/v1/account
Returns the account that this API key belongs to, including the environment, the products the account can use, and the current billing balance.
This is the recommended first call for any new integration: it lets you confirm that your
credentials work, that you are pointed at the expected environment (live or sandbox),
and that the products you intend to use are enabled on the account.
Sub accounts
For a sub account API key:
parent_account_uuidis populated with the parent (reseller) account's UUID.balance,credit_limitandavailable_creditare sourced from the parent account because that is the account charges are billed against.productsis the intersection of the parent's products and the sub account's own products - that is, the products this sub account can actually use.
Responses
Account response
application/json
| Field | Description |
|---|---|
data |
object |
data. |
string (uuid) The account's UUID |
data. |
string The display name of the account |
data. |
string The legal/company name on file for the account |
data. |
string Which environment this account (and any keys on it) operate in:
|
data. |
boolean Whether this account is a reseller (i.e. has sub accounts under it). The Reseller functionality itself (managing sub accounts) is portal-only - this flag is exposed so integrators can detect that they are operating against a reseller account. |
data. |
string (uuid) or null The UUID of the parent account when this account is a sub account of a reseller.
|
data. |
string (date-time) or null ISO 8601 timestamp at which the account is scheduled to expire. |
data. |
integer or null Account-level data retention in days. |
data. |
string Current cash balance for the billing account, as a decimal string with 4 decimal places. For sub accounts this is the parent's balance because charges are billed to the parent. Negative values indicate the account has been billed beyond its cash balance and is consuming credit limit. |
data. |
string Credit limit for the billing account, as a decimal string with 4 decimal places.
Calls remain billable while |
data. |
string Convenience field equal to |
data. |
array of objects The list of products this account can actually use. Each entry is a product the account is entitled to call billable endpoints against. For sub accounts, this is the intersection of the parent's products and the sub account's own product entitlements (a sub account cannot use a product the parent does not have, and the reseller can further restrict what the sub account can use). |
data. |
string Stable machine-readable product key. Use this in code paths that decide which endpoints to call. |
data. |
string Human-readable product name. Suitable for display in dashboards. |
data. |
string (date-time) ISO 8601 timestamp at which the account was created |
data. |
string (date-time) ISO 8601 timestamp at which the account was last updated |
api_reference |
string (uuid) |