# Access request for elastic tokens

API to request products, features or other items that will be charged for using elastic tokens.

Endpoint: POST /v1.0/instances/{instanceId}/access-request
Version: 1.0
Security: AdministrationAccess, ClientAccess

## Path parameters:

  - `instanceId` (string, required)
    The UUID of the Dynamic Monetization instance.

## Request fields (application/json):

  - `requester` (object, required)
    Requester details.

  - `requester.type` (string, required)
    Type of the requester.

  - `requester.value` (string, required)
    Unique identifier for the requester.

  - `requester.dictionary` (object)
    Dictionary of additional information about the requester. Will be used to evaluate actions defined on line items.

  - `requestedItems` (array, required)
    A list of requested items.

  - `requestedItems.item` (string, required)
    The requested item.

  - `requestedItems.version` (string)
    The version of the item requested. This field may only be omitted or left blank if the intention is to access an item in a rate table with an empty or unspecified version.

  - `requestedItems.count` (number, required)
    Number of instances of the requested item required. The value can be fractional.

  - `requestedItems.metaData` (object)
    (Optional) For sending custom data with the request, which will be sent to the data warehouse with the usage information to assist with analyzing access activity. The meta data content must be a valid JSON object.

## Response 200 fields (application/json):

  - `requestedItems` (array)
    List of requested items.

  - `requestedItems.count` (number)
    Number of instances of the requested item granted. The value can be fractional.

  - `requestedItems.item` (string)
    The name of a requested item.

  - `requestedItems.version` (string)
    The version of a requested item.

  - `requestedItems.totalTokensCharged` (number)
    Total number of tokens charged across all line items. The value can be fractional.

  - `requestedItems.lineItems` (array)
    List of line items charged to fulfill this request.

  - `requestedItems.lineItems.rate` (number)
    Rate applied. The value can be fractional.

  - `requestedItems.lineItems.activationId` (string)
    Activation ID of line item charged to fulfill the request.

  - `requestedItems.lineItems.tokensCharged` (number)
    Number of tokens charged. The value can be fractional.

  - `requestedItems.lineItems.actionId` (string)
    Unique identifier of the action and allocation used if the access request was fulfilled from an allocation within the line item.

  - `requestedItems.status` (object)
    The response status to the request for the specific item.

  - `requestedItems.status.code` (string)
    Possible values
* 101 (Successfully checked out)
* 102 (No Status)
* 201 (Item not found in any effective rate table)
* 301 (No valid active line items)
* 306 (Insufficient count available)
* 4001 (Failed due to internal server error) There was an internal error processing the request. If you need to contact support, please include the correlationId provided in the response.

  - `requestedItems.status.description` (string)
    A user-readable message explaining the status code.
    Example: "Successfully checked out."

  - `requester` (object)
    The details of the requester making the access request.

  - `requester.type` (string, required)
    Type of the requester.

  - `requester.value` (string, required)
    Unique identifier for the requester.

  - `requester.dictionary` (object)
    Dictionary of additional information about the requester. Will be used to evaluate actions defined on line items.

  - `correlationId` (string)
    An ID for the request, generated by the service, which allows correlation of the request with usage information obtained from the data warehouse.