Module Group: Accounts
Parsing Order: 320
Database Size: 1.189 GB
The authorities_api provides access to account authority information, including owner, active, posting keys, account authorizations, and historical changes.
{
"db_path": "~/sds_data1",
"id": "authorities_api",
"group_id": "accounts",
"parsing_order": 320,
"required_modules": ["chain_api", "accounts_api"],
"parse_reversible": true,
"parsed_ops": [
"account_create",
"account_create_with_delegation",
"create_claimed_account",
"account_update",
"account_update2",
"recover_account"
]
}
Returns this module's active configuration.
Endpoint
/authorities_api/getConfig
Returns account authorizations for a specific role.
Endpoint
/authorities_api/getAccountAuths/:account/:role
Example
/authorities_api/getAccountAuths/steemchiller/posting
Parameters
| Name | Type | Optional | Allowed Values |
|---|---|---|---|
:account |
string | No | - |
:role |
string | No | owner, active, posting |
Example Response:
{
"code": 0,
"result": {
"cols": {},
"rows": []
}
}
Empty result means no account authorizations are set (only key authorizations).
Returns key authorizations for a specific role.
Endpoint
/authorities_api/getKeyAuths/:account/:role
Example
/authorities_api/getKeyAuths/steemchiller/posting
Example Response:
{
"code": 0,
"result": {
"cols": {"time": 0, "target": 1, "weight": 2},
"rows": [
[1751889159, "STM7pyVbxWHr8aBmLDkKqeM6CHEdkCt27KYhRXXd96nCpJT3t39ZH", 1]
]
}
}
Column Definitions:
| Column | Description |
|---|---|
time |
When the key was set (Unix timestamp) |
target |
Public key |
weight |
Key weight (usually 1) |
Returns all accounts that have authorized the target account for any role.
Endpoint
/authorities_api/getAccountAuthsByTarget/:account
Example
/authorities_api/getAccountAuthsByTarget/steemchiller
Example Response:
{
"code": 0,
"result": {
"cols": {"time": 0, "account": 1, "role": 2, "weight": 3},
"rows": [
[1667290596, "dip.team", 1, 1],
[1764907779, "ownertest", 3, 1],
[1619449020, "sw-test", 1, 1]
]
}
}
Role Values:
| Value | Role |
|---|---|
| 1 | Posting |
| 2 | Active |
| 3 | Owner |
Returns accounts that have authorized the target for a specific role.
Endpoint
/authorities_api/getAccountAuthsByTargetRole/:account/:role
Example
/authorities_api/getAccountAuthsByTargetRole/steemchiller/posting
Example Response:
{
"code": 0,
"result": {
"cols": {"time": 0, "account": 1, "weight": 2},
"rows": [
[1667290596, "dip.team", 1],
[1619449020, "sw-test", 1]
]
}
}
Returns accounts that have authorized other accounts, with at least the specified number of authorizations.
Endpoint
/authorities_api/getAuthorizedAccounts/:minCount
Example
/authorities_api/getAuthorizedAccounts/5
Example Response (truncated):
{
"code": 0,
"result": {
"cols": {"account": 0, "count": 1, "last_action": 2},
"rows": [
["dtube.app", 78857, 1550266572],
["busy.app", 55374, 1550262861],
["steemauto", 43133, 1591391952],
["dlive.app", 29308, 1550264379],
["drugwars.app", 25674, 1724853264],
["steemhunt.com", 22150, 1550264619],
["partiko-steemcon", 20281, 1550306505],
["dmania.app", 17524, 1550264277],
["esteemapp", 13567, 1613665014],
["fundition.app", 12576, 1614213420],
["wherein", 12158, 1767629976],
["utopian.app", 11400, 1525443147],
["steempeak.app", 10958, 1580763063],
["smartsteem", 9665, 1591340745]
]
}
}
Top Apps by Account Authorizations:
| App | Authorizations |
|---|---|
| dtube.app | 78,857 |
| busy.app | 55,374 |
| steemauto | 43,133 |
| dlive.app | 29,308 |
| drugwars.app | 25,674 |
| steemhunt.com | 22,150 |
Returns the authorization history for an account (accounts that were previously authorized).
Endpoint
/authorities_api/getAccountAuthsHistory/:account/:role
Example
/authorities_api/getAccountAuthsHistory/steemchiller/posting
Example Response:
{
"code": 0,
"result": {
"cols": {"time": 0, "account": 1, "weight": 2},
"rows": [
[1727430039, "upvu.web", 1]
]
}
}
This shows @steemchiller previously authorized @upvu.web for posting.
Returns the key authorization history for an account (key changes over time).
Endpoint
/authorities_api/getKeyAuthsHistory/:account/:role
Example
/authorities_api/getKeyAuthsHistory/steemchiller/posting
Example Response:
{
"code": 0,
"result": {
"cols": {"time": 0, "key": 1, "weight": 2},
"rows": [
[1495039707, "STM8bCyv6kD2SiUxd3pKpBQmBptx8BriyV7sFMVHVnawRb3eyPy6h", 1],
[1751889159, "STM7pyVbxWHr8aBmLDkKqeM6CHEdkCt27KYhRXXd96nCpJT3t39ZH", 1]
]
}
}
This shows @steemchiller's posting key was: