# List Activation Challenges for a person

Returns a list of activation challenges based on the filter criterias.

Endpoint: GET /v1/mfa/challenges/activation
Version: 1.0

## Query parameters:

  - `page[size]` (integer)
    Use this filter to specify the size of each page of results.

  - `page[number]` (integer)
    Use this filter to return only the devices on a certain page of the response.

  - `filter[person_id]` (string)
    Use this filter to return only challenges that belong to a specific person.

  - `filter[include_expired]` (string)
    Boolean value that determines whether or not the API should also return expired challenges. Default value is false.

  - `filter[origin]` (string)
    Use this filter to return only challenges that belong to a specific orign

  - `filter[purpose]` (string)
    Use this filter to return only challenges that belong to a specific purpose

  - `filter[delivery_method]` (string)
    Use this filter to return only challenges that belong to a specific delivery method

## Response 200 fields (application/json):

  - `id` (string)
    The ID of the challenge.
    Example: "6642d15e-8f6b-4d28-9186-cdd61d80032a"

  - `person_id` (string)
    The ID of the person for whom the activation code is created
    Example: "55e47118b78741dbb81cdd3d372bc448cpar"

  - `code` (string)
    activation code
    Example: "code123456abcd"

  - `created_at` (string)
    The date and time when the code was created.
    Example: "2022-03-18T14:50:04Z"

  - `expires_at` (string)
    The date and time when the code will expire.
    Example: "2022-03-18T14:55:04Z"

  - `origin` (string)
    Origin of the request. Origin specifed while creating a new activation code is returned here. "SOLARISBANK" is a reserved origin value which will be used by solarisbank for internally generated requests.
    Example: "MOBILE_APP"

  - `purpose` (string)
    Purpose of the activation_code.  The generated activation_code can be used only for the desired purpose. Currently the only supported purpose is DEVICE_BINDING. More purposes may be supported in future.
    Example: "DEVICE_BINDING"

  - `delivery_method` (string)
    Partner's method of delivering activation code to the endcustomer.
    Example: "SNAILMAIL"

  - `usage_count` (integer)
    The number of times the activation code has been used.
    Example: 1

  - `max_usage_count` (integer)
    The maximum number of times the activation code can be used.
    Example: 5

## Response 400 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 401 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 403 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 404 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID

## Response 500 fields (application/json):

  - `errors` (array)

  - `errors.id` (string, required)
    Correlation/Request ID

  - `errors.status` (integer, required)

  - `errors.code` (string, required)

  - `errors.title` (string, required)

  - `errors.detail` (string, required)

  - `errors.source` (object)

  - `errors.source.field` (string)

  - `errors.source.message` (string)

  - `errors.error_code` (string)
    Correlation/Request ID