# List secrets

Retrieves the information of the secrets.

Endpoint: GET /v1/secrets
Version: 1.0
Security: x-api-key

## Query parameters:

  - `secret` (array)
    Identifier field of secrets

  - `type` (array)
    Secret types on which the filter will be applied
    Enum: "SSHKeyPath", "SSHKeyReference", "SSHPassword", "SSHKerberosTGTKeyTabFile", "SSHKerberosTGTPassword", "SecretFile", "SecretText", "WinRmTGTKeyTabFile", "WinRmTGTPassword", "WinRmNTLM"

  - `recursive` (boolean)
    Expand current scope to include all child scopes

  - `search_term` (string)
    This would be used to filter resources having attributes matching with search term.

  - `page` (integer)
    Pagination page number strategy: Specify the page number within the paginated collection related to the number of items in each page

  - `limit` (integer)
    Number of items to return per page.

  - `sort` (string)
    Parameter on the basis of which sorting is done.
    Enum: "name", "identifier", "created", "updated"

  - `order` (string)
    Order on the basis of which sorting is done.
    Enum: "ASC", "DESC"

## Header parameters:

  - `Harness-Account` (string)
    Identifier field of the account the resource is scoped to. This is required for Authorization methods other than the x-api-key header. If you are using the x-api-key header, this can be skipped.

## Response 200 fields (application/json):

  - `secret` (object)

  - `secret.name` (string, required)
    Secret name

  - `secret.identifier` (string, required)
    Secret identifier

  - `secret.org` (string)
    Organization identifier for secret

  - `secret.project` (string)
    Project identifier for secret

  - `secret.tags` (object)
    Secret tags

  - `secret.description` (string)
    Secret description

  - `secret.spec` (object, required)
    Details of the secret defined in Harness

  - `secret.spec.type` (string, required)
    This specifies the type of secret
    Enum: "SSHKeyPath", "SSHKeyReference", "SSHPassword", "SSHKerberosTGTKeyTabFile", "SSHKerberosTGTPassword", "SecretFile", "SecretText", "WinRmTGTKeyTabFile", "WinRmTGTPassword", "WinRmNTLM"

  - `created` (integer)
    Creation timestamp for the secret

  - `updated` (integer)
    Updated timestamp for the secret

  - `draft` (boolean)

  - `governance_metadata` (object)
    Governance metadata information