ARTIFACTORY: What are the query parameters to filter the GET Access token API response?

AuthorFullName__c
Anusha M
articleNumber
000005540
FirstPublishedDate
2023-01-08T07:46:52Z
lastModifiedDate
2025-07-22

ARTIFACTORY: What are the query parameters to filter the GET Access token API response?

This article is about the available query parameters to filter the GET Access token REST API response. 
We can filter the response by specifying the details based on the username/description/refreshable.
Currently, Artifactory supports 3 query parameters to filter the GET Access token REST API:

  • username=<username> (enter the username that needs to be filtered)
  • description=<description> (supports wildcard, the wildcard must be at the end of the text)
  • refreshable=<true|false>


1.  We can use the query parameter “username” with the GET Access token REST API to filter the tokens based on the username.
           
Command: 

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?username=<username>"
{
  "tokens": [  {
      "token_id": "<id>",
      "subject": "<subject>",    
      "issued_at": <epoch-in-secs>,
      "issuer": "<issuer>",
      "description": "<description>",
      "refreshable": <true|false>
    }  ]
}


Below is the sample for the query parameter ‘username’:

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?username=anusha"

User-added image


2.  We can use the query parameter “description” with the GET Access token REST API to filter the tokens based on the description.

Command: 

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?description=<description>"


Below is the sample for query parameter ‘description’ :

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?description=anusha-accesstoken"


User-added image


3.  We can use the query parameter “refreshable” with the GET Access token REST API to filter the tokens.

Command:

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?refreshable=<true|false>"


Below is the sample for query parameter ‘refreshable’’ :

curl -H "Authorization: Bearer <valid access token>" "http://localhost:8082/access/api/v1/tokens?refreshable=false"


User-added image