# Fetch playback token keys

This operation shows details for playback token keys you've created that are available in Wowza Video for your account. The details include a key id which you use to create a playback token for advanced token authentication. 

Before using the ADVANCED_TOKEN option as your token authentication for a video, you must do one of the following: 

 - Generate a playback token key that has a key id using the POST /playback_tokens/keys endpoint in the Wowza Video API, then customize and generate a token via Wowza Video 2.0 API to add to your site. You'll need the key id to create and sign the token.  
 - Generate a playback token key that has a key id and key value using the POST /playback_tokens/keys endpoint in the Wowza Video 2.0 API, then customize and generate a standard common access token (CAT) through the means you usually use to create tokens to add to your site. You'll need the key id and key to create and sign the token. 
   You received the key value in the response when you created the playback token key.

Endpoint: GET /playback_tokens/keys
Version: v2.0

## Query parameters:

  - `query` (string)
    Name is the only searchable field.

Limit to a specific field with a colon (:).

If you have multiple search terms you can use pipe (|) to separate the search terms.

Examples:

 | Query | Description |
 | ----- | ----------- |
 | query=foo | Searches name & description field for foo. |

  - `page` (integer)
    Returns a paginated view of results from the HTTP request. Specify a positive integer to indicate which page of the results should be displayed. The default is 1. 

 For more information and examples, see Get paginated query results with the Wowza Video REST API.

  - `per_page` (integer)
    For use with the page parameter. Indicates how many records should be included in a page of results. A valid value is any positive integer. The default and maximum value is 1000.

## Response 200 fields (application/json):

  - `playback_token_keys` (array)
    The list of playback token keys.

  - `playback_token_keys.id` (string)
    Unique identifier for the playback token key. It will contain the organization identifier.

  - `playback_token_keys.organization_id` (string)
    The organization id.

  - `playback_token_keys.name` (string)
    The name of the playback token key for the organization.

  - `playback_token_keys.created_at` (string)
    The playback token creation timestamp.
    Example: "2020-01-01T12:33:22Z"

  - `pagination` (object)
    Page information for the results generated by the query.

  - `pagination.payload_version` (integer)
    The pagination object version.

  - `pagination.total_records` (integer)
    The total number of records in the database that match the query.

  - `pagination.page` (integer)
    The page number, starting at 1. The default is 1.

  - `pagination.per_page` (integer)
    The number of records included per page. The default is 20.

  - `pagination.total_pages` (integer)
    The total number of pages generated by the query.

  - `pagination.page_first_index` (integer)
    The index of the first record in the response.

  - `pagination.page_last_index` (integer)
    The index of the last record in the response.

## Response 401 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 403 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 404 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)

## Response 410 fields (application/json):

  - `meta` (object, required)

  - `meta.status` (integer)

  - `meta.code` (string)

  - `meta.title` (string)

  - `meta.message` (string)

  - `meta.description` (string)

  - `meta.links` (array)