Skip to main content

Get tokens by transaction ID


Returns the list of token IDs associated with a transaction ID, an optional identifier passed to the tokenize operation.

The role performing this operation must have the CapTransactionIdReader capability, or another capability that matches the URL, such as the CapDataReader capability.


Path parameters

  • id - string required*

    The transaction ID.

  • collection - string required*

    The name of a collection.

Query parameters

  • adhoc_reason - string

    An ad-hoc reason for accessing the Vault data. Required when reason is set to Other.

  • reason - string required*

    Details of the reason for requesting the property. The default is set when no access reason is provided and PVAULT_SERVICE_FORCE_ACCESS_REASON is false.

  • reload_cache - boolean

    Reloads the cache before the action.

Possible responses

The request is successful.

object required*

The list of referenced token IDs.

  • ref_ids - array of strings
    Each string:

    The ID of a referenced token.

"ref_ids": [

Try the API


Path parameters

Query parameters

Navigate to the docs of your local Vault installation to try the API directly from there.

Code examples