---
title: "Get connection version details"
method: GET
path: "/token/connections/{connectionId}/versions/{connectionVersionId}"
tags: ["Vault Proxy Connections"]
---

# Get connection version details

`GET /token/connections/{connectionId}/versions/{connectionVersionId}`

Get connection version details by connection id and version id.

## Path parameters

- `connectionId` string, uuid, required
- `connectionVersionId` string, uuid, required

## Response `200`

Success.

- object
  - `name` string — Name of connection version.
  - `description` string — Description of connection version.
  - `httpMethods` string[] — HTTP Methods this connection should be invoked by. You can create different connections that are invoked using same URL but which should behave differently depending on method. For example, there can be connection version that handles requests for "GET /orders" and another connection that handles requests for "POST /orders".
  - `publicUrl` string — Public url that will be invoked by third party or merchant.
  - `anyOf` object
    - `proxyUrl` string — The proxy URL is primarily the URL where requests are forwarded after tokenization or de-tokenization. It applies to inbound connections.
    - `trustedDestinationHosts` string[] — The destination hosts are a list of whitelisted hosts to which outbound connections can be proxied.
  - `rules` union[]
    - union
      - object
        - `action` 'tokenization' — The action required by this rule. Examples of actions include tokenization and detokenization.
        - `config` object
          - `targetRecordType` 'card' | 'networkToken', required — RecordType that has to be parsed and tokenized from Payload.
          - `targetContentType` 'xml' | 'json' | 'formurlencoded' | 'xmlformurlencoded', required — ContentType of target payload that need to be parsed.
          - `expiresIn` integer — ExpiresIn refers to the duration in seconds or time remaining before a record becomes invalid or deleted.
          - `recordSelector` string — XPath or JSONPath selector for parsing specified record.
          - `fields` object, required
            - `cardNumber` object, required — Rule for parsing cardNumber from Payload.
              - …
            - `securityCode` object — Rule for parsing securityCode from Payload.
              - …
            - `expiryMonth` object, required — Rule for parsing expiryMonth from Payload.
              - …
            - `expiryYear` object, required — Rule for parsing expiryYear from Payload.
              - …
            - `holderName` object — Rule for parsing cardHolderName from Payload.
              - …
      - object
        - `action` 'tokenization' — The action required by this rule. Examples of actions include tokenization and detokenization.
        - `config` object
          - `targetRecordType` 'card' | 'networkToken', required — RecordType that has to be parsed and tokenized from Payload.
          - `targetContentType` 'xml' | 'json' | 'formurlencoded' | 'xmlformurlencoded', required — ContentType of target payload that need to be parsed.
          - `expiresIn` integer — ExpiresIn refers to the duration in seconds or time remaining before a record becomes invalid or deleted.
          - `recordSelector` string — XPath or JSONPath selector for parsing specified record.
          - `fields` object, required
            - `networkToken` object, required — Rule for parsing networkToken - accountNumber from Payload.
              - …
            - `cryptogram` object — Rule for parsing cryptogram from Payload.
              - …
            - `expiryMonth` object, required — Rule for parsing expiryMonth from Payload.
              - …
            - `expiryYear` object, required — Rule for parsing expiryYear from Payload.
              - …
      - object
        - `action` 'detokenization' — The action required by this rule. Examples of actions include tokenization and detokenization.
        - `config` object
          - `targetRecordType` 'card' | 'networkToken', required — RecordType that has to be parsed and tokenized from Payload.
          - `targetContentType` 'xml' | 'json' | 'formurlencoded' | 'xmlformurlencoded', required — ContentType of target payload that need to be parsed.
          - `expiresIn` integer — ExpiresIn refers to the duration in seconds or time remaining before a record becomes invalid or deleted.
          - `recordSelector` string — XPath or JSONPath selector for parsing specified record.
          - `fields` object, required
            - `cardNumber` object, required — Rule for parsing cardNumber from Payload.
              - …
            - `securityCode` object — Rule for parsing securityCode from Payload.
              - …
            - `expiryMonth` object, required — Rule for parsing expiryMonth from Payload.
              - …
            - `expiryYear` object, required — Rule for parsing expiryYear from Payload.
              - …
            - `holderName` object — Rule for parsing cardHolderName from Payload.
              - …
      - object
        - `action` 'detokenization' — The action required by this rule. Examples of actions include tokenization and detokenization.
        - `config` object
          - `targetRecordType` 'card' | 'networkToken', required — RecordType that has to be parsed and tokenized from Payload.
          - `targetContentType` 'xml' | 'json' | 'formurlencoded' | 'xmlformurlencoded', required — ContentType of target payload that need to be parsed.
          - `expiresIn` integer — ExpiresIn refers to the duration in seconds or time remaining before a record becomes invalid or deleted.
          - `recordSelector` string — XPath or JSONPath selector for parsing specified record.
          - `fields` object, required
            - `networkToken` object, required — Rule for parsing networkToken - accountNumber from Payload.
              - …
            - `cryptogram` object — Rule for parsing cryptogram from Payload.
              - …
            - `expiryMonth` object, required — Rule for parsing expiryMonth from Payload.
              - …
            - `expiryYear` object, required — Rule for parsing expiryYear from Payload.
              - …
      - object — Function that executed as part of this rule.
        - `action` 'customFunction' — The action required by this rule. Examples of actions include tokenization and detokenization.
        - `function` object — Custom function that will be executed as part of this rule.
          - `identifier` 'maskedCardInRequestHeaders' — Unique name of custom function that will be executed part of this rule.
  - `status` string

## Other responses

- `401` — Unauthorized.
- `403` — Insufficient Scope.
- `404` — Not Found.

---

[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)