# Generated by Scrape::ApiDefinitionsJob: 2018-12-18 22:30:11 UTC
# See: https://git.io/vx5CY
---
- name: :reputation_api
  description: |
    Needed by `condenser_api` to optionally use `follow_api` or `reputation_api`
    for account reputations (the latter if [`hivemind`]({{ '/tutorials-recipes/using-hivemind.html' | relative_url }}) is fronting `follow_api`)
  methods:
  - api_method: reputation_api.get_account_reputations
    since: HF20
    purpose: |
      Returns the reputation of accounts.  Parameters: `account:string`; `limit:int`

      * `limit` is up to 1000.

      | `account` (string) | `limit` (int) | |
      |--------------------|-|
      | `"hiveio"` | 10 | Queries the reputation for account named "hiveio". |

      See [#1425](https://github.com/steemit/steem/issues/1425)
      
      Also see: [Paginated API Methods]({{ '/tutorials-recipes/paginated-api-methods.html#reputation_apiget_account_reputations' | relative_url }})
    parameter_json: '{"account_lower_bound":"","limit":1000}'
    expected_response_json: | # TODO - recheck in HF23
      {
        "account": "steem",
        "reputation": 0
      }
    curl_examples:
    - '{"jsonrpc":"2.0", "method":"reputation_api.get_account_reputations", "params": {"account_lower_bound": "steem"}, "id":1}'
    client_docs:
      - '[hive-js](https://gitlab.syncad.com/hive/hive-js/tree/master/doc#get-account-reputations)'
      - '[beem](https://beem.readthedocs.io/en/latest/beem.account.html#beem.account.Account.get_reputation)'
      - '[hive-ruby](https://www.rubydoc.info/gems/hive-ruby/Hive/Api)'
