# List Mailgun API keys

List Mailgun API keys

Endpoint: GET /v1/keys
Version: 3.0.0
Security: basicAuth

## Query parameters:

  - `domain_name` (string)
    Domain name filter for domain keys

  - `kind` (string)
    Key kind filter
    Enum: "domain", "user", "web"

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (string, required)
    The ID for the key

  - `items.description` (string, required)
    The description provided for the key upon its creation

  - `items.kind` (string, required)
    The type of the key which determines how it can be used

  - `items.role` (string, required)
    The role of the key which determines its scope in CRUD operations that have role-based access control

  - `items.created_at` (string, required)
    When the key was created

  - `items.updated_at` (string, required)
    When the key was last updated

  - `items.expires_at` (string)
    When the key will expire

  - `items.secret` (string)
    The full api key secret in plain text

  - `items.disabled_reason` (string)
    The reason for the key's disablement

  - `items.is_disabled` (boolean, required)
    Whether or not the key is disabled from use

  - `items.domain_name` (string,null, required)
    The sending domain associated with the key

  - `items.requestor` (string,null, required)
    An email address associated with the key

  - `items.user_name` (string,null, required)
    The api key user's name

  - `total_count` (integer, required)
    The number of keys returned in 'items'

## Response 400 fields (application/json):

  - `message` (string, required)
    Response message