---
title: "Get field details by alias list"
method: GET
path: "/token/records/fields"
tags: ["Vault Records and Aliases"]
---

# Get field details by alias list

`GET /token/records/fields`

Get field details for multiple provided aliases. The order in which aliases returned may not match the order in
which you passed the aliases in request. Not found fields will be ignored: if you request fields by aliases
a, b, c and there is no field with alias b, then only fields a and c are returned.

## Query parameters

- `aliases` string, required
- `includeVolatileInfo` boolean
- `includeDetokenizations` boolean

## Response `200`

Array of Field objects.

- object[]
  - `alias` string — Merchant-facing unique alias for the field. Used as an identifier.
  - `recordId` string — Identifier of the record to which the alias belongs.
  - `recordType` string — Record type to which this field belongs, e.g. `card` and `networkToken`.
  - `fieldType` string — Field type of the alias, e.g. `cardNumber`, `expiryMonth`, `expiryYear`, `securityCode`, `holderName`, `networkToken`, `cryptogram`.
  - `displayableValue` string, nullable — Displayable value for the field.
  - `allowedDetokenizationCount` integer, nullable — It will be restricted if used on a proxy and reaches the limit mentioned in this field.
  - `allowedSdkRevealCount` integer, nullable — It will be restricted if used on a SDK reveal and reaches the limit mentioned in this field.
  - `hasValue` boolean, nullable — Indicates whether the volatile field has a value associated with it. If false or not present, the field has been deleted or was never set.
  - `maximumExpirationDate` string, date-time, nullable — The maximum expiration date for the volatile field value. After this date, the field value will be deleted. Please note that depending on usage of volatile field, value can be deleted even earlier, for example if allowed detokenization or reveal counts are exceeded, or when you explicitly call delete operation on the field.
  - `detokenizations` object[], nullable — List of detokenization attempts performed on this field. This field is returned only when requested via `includeDetokenizations` query parameter.
    - `lastAttemptedAt` string, date-time — Timestamp when the detokenization was attempted.
    - `count` integer — Number of times this type of detokenization was successfully performed.
    - `type` 'detokenization' | 'sdkReveal' — Type of detokenization attempt. `detokenization` indicates a standard detokenization, while `sdkReveal` indicates a detokenization performed via SDK reveal.

## Other responses

- `401` — Unauthorized.
- `403` — Insufficient Scope.
- `422` — Unprocessable Entity.

---

[API](https://skmtc.net/payrails/apis/payrails-api-reference.md) · [All operations](https://skmtc.net/payrails/apis/payrails-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payrails/payrails-api-reference/revisions/9dd2f0158582/schema)