---
title: "Calculated Feature values"
method: GET
path: "/v2/auth_rules/{auth_rule_token}/features"
tags: ["Auth Rules"]
---

# Calculated Feature values

`GET /v2/auth_rules/{auth_rule_token}/features`

Fetches the current calculated Feature values for the given Auth Rule

This only calculates the features for the active version.
- VelocityLimit Rules calculates the current Velocity Feature data. This requires a `card_token` or `account_token` matching what the rule is Scoped to.
- ConditionalBlock Rules calculates the CARD_TRANSACTION_COUNT_* attributes on the rule. This requires a `card_token`

## Path parameters

- `auth_rule_token` string, uuid, required

## Query parameters

- `account_token` string, uuid
- `card_token` string, uuid

## Response `200`

Calculated Feature values for the given Auth Rule

- AuthRuleFeatureState
  - `evaluated` string, date-time, required — Timestamp at which the Features were evaluated
  - `features` SpendFeatureState[], required — Calculated Features used for evaluation of the provided Auth Rule
    - `scope` 'CARD' | 'ACCOUNT', required — The scope the velocity is calculated for
    - `period` union, required
      - object
        - `duration` integer, required — The size of the trailing window to calculate Spend Velocity over in seconds. The minimum value is 10 seconds, and the maximum value is 7776000 seconds (90 days).
        - `type` 'CUSTOM', required
      - object — Velocity over the current day since 00:00 / 12 AM in Eastern Time
        - `type` 'DAY', required
      - object — Velocity over the current week since 00:00 / 12 AM in Eastern Time on specified `day_of_week`
        - `type` 'WEEK', required
        - `day_of_week` integer — The day of the week to start the week from. Following ISO-8601, 1 is Monday and 7 is Sunday. Defaults to Monday if not specified.
      - object — Velocity over the current month since 00:00 / 12 AM in Eastern Time on specified `day_of_month`.
        - `type` 'MONTH', required
        - `day_of_month` integer — The day of the month to start from. Accepts values from 1 to 31, and will reset at the end of the month if the day exceeds the number of days in the month. Defaults to the 1st of the month if not specified.
      - object — Velocity over the current year since 00:00 / 12 AM in Eastern Time on specified `month` and `day_of_month`. This validates the month and day of the year to start from is a real date. In the event that February 29th is selected, in non-leap years, the window will start from February 28th.
        - `type` 'YEAR', required
        - `day_of_month` integer — The day of the month to start from. Defaults to the 1st of the month if not specified.
        - `month` integer — The month to start from. 1 is January and 12 is December. Defaults to January if not specified.
    - `filters` VelocityLimitFilters, required
      - `include_mccs` string[], nullable — Merchant Category Codes to include in the velocity calculation. Transactions not matching this MCC will not be included in the calculated velocity.
      - `exclude_mccs` string[], nullable — Merchant Category Codes to exclude from the velocity calculation. Transactions matching this MCC will be excluded from the calculated velocity.
      - `include_countries` string[], nullable — ISO-3166-1 alpha-3 Country Codes to include in the velocity calculation. Transactions not matching any of the provided will not be included in the calculated velocity.
      - `exclude_countries` string[], nullable — ISO-3166-1 alpha-3 Country Codes to exclude from the velocity calculation. Transactions matching any of the provided will be excluded from the calculated velocity.
      - `include_pan_entry_modes` string[], nullable — PAN entry modes to include in the velocity calculation. Transactions not matching any of the provided will not be included in the calculated velocity.
    - `value` object, required
      - `amount` integer, required — Amount (in cents) for the given Auth Rule that is used as input for calculating the rule. For Velocity Limit rules this would be the calculated Velocity. For Conditional Rules using CARD_TRANSACTION_COUNT_* this will be 0
      - `count` integer, required — Number of velocity impacting transactions matching the given scope, period and filters

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/versions/53ab5d4e2adb/schema)