# Return SSH keys list

This function lists the server's SSH keys.



Only the  account can use this function, and it only affects the 
keys. To perform this function on a regular user account, call the cPanel API
2  function through the WHM API.

Endpoint: GET /listsshkeys
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `files` (string)
    A filename, to limit the results to keys that have that filename.
    Example: "TestKey"

  - `private` (integer)
    Whether to display only private keys.

*  — Display only private keys.
*  — Display all keys.
    Enum: 0, 1

  - `private_texts` (integer)
    Whether to include private key text.

*  — Include private key text.
*  — Do  include private key text.
    Enum: 0, 1

  - `public` (integer)
    Whether to display only public keys.

*  — Display only public keys.
*  — Display all keys.
    Enum: 0, 1

  - `public_texts` (integer)
    Whether to include public key text.

*  — Include public key text.
*  — Do  include public key text.
    Enum: 0, 1

  - `sync_authorized` (integer)
    Whether to synchronize the keys that can access the server.

*  — Synchronize the keys.
*  — Do  synchronize the keys.
    Enum: 0, 1

## Response 200 fields (application/json):

  - `data` (object)

  - `data.keys` (array)
    An array of objects of each key's information.

  - `data.keys.authorized` (integer)
    Whether the key is authorized to access the server.

*  — Authorized.
*  —  authorized.
    Enum: 0, 1

  - `data.keys.comment` (string)
    The key's comment.
    Example: "REPO username@example.com"

  - `data.keys.ctime` (integer)
    The date that the key was created, in
[Unix time format](http://en.wikipedia.org/wiki/Unix_time).
    Example: 1416596824

  - `data.keys.file` (string)
    The key's filename.
    Example: "TestKey"

  - `data.keys.mtime` (integer)
    The date that the key will expire, in Unix time format.
    Example: 1416596824

  - `data.keys.private` (integer)
    Whether the private key is stored on the server.

*  — The private key is on the server.
*  — The private key is  on the server.
    Enum: 0, 1

  - `data.keys.text` (string)
    The key's text.
    Example: "ssh-rsaXXXXX3XXXX1XX2XXXXXXXXXXXXXXxXXXX6XXXXX90X41X7XXXXX02XXXXX8XXXX54XXXXXXXXXXX2X07XXXXXXXXXXX7XXXX4XXX2X98XXXX98X80XXXXXXX7X/X4XXXXxX1XXXXXXXXXXXxXXXXXXXXX6+4XXXX36XXXXX3XXXXXX1XXXXXXX/X7+XX1XX6XXXX0XXXXXXX0XXXXXXXX+XxX99X7X2XXXXXX03xXXXXX0XXXXXXXXXX9XXXXXXX9XXXXXXXXXXXX/XXXXX07XXXXX3XXXXXX5XXX+/XXXXXXXXXXXXX3XxXXXXXXXXXXXX6XXXXXXXXXXXX2XXXXXXXXXXXXXXXXX3XX+XXXX3XXXXXXX== REPO username@example.com"

  - `metadata` (object)

  - `metadata.command` (string)
    The method name called.
    Example: "listsshkeys"

  - `metadata.reason` (string)
    The reason the API function failed when the  field is . This field may display a success message when a function succeeds.
    Example: "OK"

  - `metadata.result` (integer)
    *  — Success.
*  — Failed. Check the  field for more details.
    Enum: 0, 1

  - `metadata.version` (integer)
    The version of the API function.
    Example: 1