---
title: "GET /v1/links/{id}"
method: GET
path: "/v1/links/{id}"
---

# GET /v1/links/{id}

`GET /v1/links/{id}`

Get Tokenization Link status

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `status` 'PENDING' | 'SUCCESS' | 'ERROR' — Status
  - `reference` string — Reference submitted during generation
  - `link` string — URL of the public Tokenization page
  - `paymentMethod` 'VIS' | 'ECA' | 'AMX' | 'DIN' | 'DIS' — Payment method
  - `card` object — If a credit card payment method was used for a transaction the `card` object holds all relevant properties for the used card.
    - `alias` string — The resulting alias, if requested or available.
    - `fingerprint` string — An unique identifier of the card number. Useful to identify multiple customers' or the same customer's transactions where the same card was used.
    - `masked` string — Masked credit card number. Can be used to display on a users profile page. For example: `424242xxxxxx4242`
    - `aliasCVV` string — Alias of the CVV. Will be deleted immediately after authorization.
    - `expiryMonth` string — The expiry month of the credit card alias.
    - `expiryYear` string — The expiry year of the credit card alias
    - `cardholderName` string — If `collectCardholderName` is enabled, this property will hold its value.
    - `info` object — The card information if the request was done with a card object
      - `brand` string — The brand of the credit card (e.g. VISA CREDIT).
      - `type` string — The type of the card (`credit`, `debit` or `prepaid`). The property will not be present if the card type is unknown.
      - `usage` string — The usage of the card (`consumer`, `corporate` or `unknown`)
      - `country` string — 2 letter ISO 3166-1 alpha-2 country code
      - `issuer` string — The issuer of the card
      - `accountType` 'PAN' | 'TOKEN'
    - `walletIndicator` 'APL' | 'PAY' | 'SAM' | 'VPS' | 'MBP'
    - `3D` object — 3D authentication data, if available
      - `eci` '01' | '02' | '05' | '06' | '07' — The Electronic Commerce Indicator
      - `xid` string — The transaction ID returned by the directory server
      - `threeDSTransactionId` string — The transaction ID returned by the 3D Secure Provider
      - `cavv` string — The Cardholder Authentication Verification Value
      - `threeDSVersion` string — The 3D version
      - `cavvAlgorithm` string — The 3D algorithm
      - `directoryResponse` 'Y' | 'N' | 'U' | 'C' | 'R' | 'A' — Transaction status after `ARes` |Value|3Dv1|3Dv2| |:---|:---|:---| |Y| enrolled| authenticated| |N| not enrolled| authentication failed| |U| not available| not available| |C| |challenge needed| |R| |rejected| |A| |authentication attempt|
      - `authenticationResponse` 'Y' | 'N' | 'U' | 'A' | 'C' | 'D' — Transaction status after `RReq` (Challenge flow) |Value|3Dv1|3Dv2| |:---|:---|:---| |Y| authenticated| authenticated| |N| authentication failed| authentication failed| |U| not available| not available| |A| authentication attempt| authentication attempt| |C| process incomplete| process incomplete| |D| not enrolled| |
      - `transStatusReason` string — Transaction status reason |Value|Description| |:---|:---| |01| Card authentication failed| |02| Unknown Device| |03| Unsupported Device| |04| Exceeds authentication frequency limit| |05| Expired card| |06| Invalid card number| |07| Invalid transaction| |08| No Card record| |09| Security failure| |10| Stolen card| |11| Suspected fraud| |12| Transaction not permitted to cardholder| |13| Cardholder not enrolled in service| |14| Transaction timed out at the ACS| |15| Low confidence| |16| Medium confidence| |17| High confidence| |18| Very High confidence| |19| Exceeds ACS maximum challenges| |20| Non-Payment transaction not supported| |21| 3RI transaction not supported| |22| ACS technical issue| |23| Decoupled Authentication required by ACS but not requested by 3DS Requestor| |24| 3DS Requestor Decoupled Max Expiry Time exceeded| |25| Decoupled Authentication was provided insufficient time to authenticate cardholder. ACS will not make attempt| |26| Authentication attempted but not performed by the cardholder| |27–79| Reserved for EMVCo future use (values invalid until defined by EMVCo)| |80–99 | Reserved for DS use|
      - `cardHolderInfo` string — Text provided by the ACS/Issuer to Cardholder during a transaction that was not authenticated by the ACS. The Issuer can optionally provide information to Cardholder. For example, "Additional authentication is needed for this transaction, please contact (Issuer Name) at xxx-xxx-xxxx."
    - `networkToken` object — Network token details. This information is only available if the card behind the alias has been tokenized.
      - `expiryMonth` string — The expiry month of the network token
      - `expiryYear` string — The expiry year of the network token
      - `status` 'INACTIVE' | 'ACTIVE' | 'SUSPENDED' | 'DELETED' | 'AUTHENTICATING' — The status of the network token
      - `paymentAccountReference` string — The Payment Account Reference of the network token
  - `history` object[]
    - `action` 'init' | 'authenticate' | 'authorize' | 'settle' | 'credit' | 'cancel' | 'change_details' — The action performed.
    - `autoSettle` boolean — Indicates if auto settlement was used. Only applicable if action was `authorize`
    - `requestId` string, uuid — Planet wide transaction Id per action.
    - `amount` integer — The amount used.
    - `source` 'admin' | 'amadeus' | 'ajax' | 'android' | 'api' | 'inline' | 'ios' | 'lightbox' | 'link' | 'redirect' | 'secure_fields' | 'system' | 'web' | 'web_hidden' | 'unknown' — From where the action originated.
    - `date` string, date-time — Date when the action was performed.
    - `success` boolean — Whether the action was successful or not.
    - `marketplace` object — If you are a marketplace merchant, use this object to send one or multiplesplits per transaction.
    - `ip` string — The IP address from where the action originated from.
  - `currency` string — 3 letter <a href='https://en.wikipedia.org/wiki/ISO_4217' target='_blank'>ISO-4217</a> character code. For example `CHF` or `USD`
  - `detail` object
    - `authorize` object
      - `amount` integer — The authorization amount.
      - `acquirerAuthorizationCode` string — The authorization code returned by the acquirer or payment method provider.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not found

---

[API](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.net/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/versions/1f4f905fd175/schema)