List data tokens

Overview

Retrieve a paginated list of data tokens associated with your profile, with optional filtering by token attributes and metadata.

Endpoint: GET /data-token/list-data-tokens

Authentication: Required (Authorization token obtained from the step)

Query Parameters

Parameter	Type	Required	Description
`page`	integer	No	Page number for pagination
`perPage`	integer	No	Number of tokens per page
`filters[meta.file.fileName]`	string	No	Filter by file name
`filters[meta.file.extension]`	string	No	Filter by file extension
`filters[meta.data.type]`	string	No	Filter by data type
`filters[context]`	string	No	Filter by context (path, namespace, or classification)
`filters[token]`	string	No	Filter by specific token identifier

Supported Filters

meta.file.fileName - File name metadata

meta.file.extension - File extension metadata

meta.data.type - Data type classification

context - Organizational context

token - Specific token identifier

Use Case

Use this endpoint to retrieve and browse all data tokens associated with your profile. Pagination supports efficient handling of large token collections, while filters enable querying specific subsets based on token attributes and metadata. This is useful for:

Auditing all tokens in your profile

Building file browsing interfaces

Finding specific tokens by attributes

Managing token lifecycle across your application

The response includes token identifiers and configured metadata for each token.

Only tokens belonging to your profile are returned
Filters operate on configured metadata - tokens without metadata may not match
Use pagination for profiles with large numbers of tokens
Combine multiple filters to narrow results

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

Example

{
    "items": [
        {
            "id": "acb21f72-7915-4a63-aad1-c1a438729061",
            "token": "example_data_token",
            "profileId": "example_profile_id",
            "context": "example_context",
            "dataSize": 15,
            "outputType": 0,
            "meta": [
                "string"
            ],
            "createdAt": "2025-02-10T10:03:06+00:00"
        }
    ],
    "meta": {
        "page": 1,
        "perPage": 25,
        "count": 1,
        "maxPage": 1
    }
}

🟠401401

🟠422422

List data tokens

Overview#

List Data Tokens#

Query Parameters#

Supported Filters#

Use Case#

Request

Request Code Samples

Responses

Overview

List Data Tokens

Query Parameters

Supported Filters

Use Case