Tags

List tags

Search and list the tags of jobs.

Authorization

To call this method, you must be assigned one or more IAM access roles that include the following actions. You can check your access by going to Users > User > Access

quantum-computing.job.read

Auditing

Calling this method generates the following auditing events.

quantum-computing.job.read

Input

Query Parameters
Name, Type	Description
type Required string	Searches for tags in the specified type. Possible values: `job` Default value: `job`
search Required string	Used for searching tags.

Code samples

GET

/v1/tags

If your instance is in the eu-de region, use this URL instead: https://eu-de.quantum.cloud.ibm.com/api/v1/tags

curl -X GET \
  https://quantum.cloud.ibm.com/api/v1/tags \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR-TOKEN' \
  -H 'Service-CRN: YOUR-SERVICE-CRN' \
  -H 'IBM-API-Version: 2026-02-15'

If your instance is in the eu-de region, use this URL instead: https://eu-de.quantum.cloud.ibm.com/api/v1/tags

import requests

response = requests.request(
    "GET",
    "https://quantum.cloud.ibm.com/api/v1/tags",
    headers={
      "Accept": "application/json",
      "IBM-API-Version": "2026-02-15",
      "Authorization": "Bearer YOUR-TOKEN",
      "Service-CRN": "YOUR-SERVICE-CRN"
    },
)
print(response.json())

Output

HTTP Response Status Codes
Status code	Description
200	OK
401	Unauthorized
403	Forbidden
404	Not Found

Responses

Status code

{
  "tags": [
    "tag1",
    "tag2",
    "tag3",
    "tag4"
  ]
}

{
  "type": "object",
  "properties": {
    "tags": {
      "title": "Tags",
      "description": "List of job or program tags",
      "type": "array",
      "minItems": 1,
      "maxItems": 5,
      "items": {
        "type": "string",
        "pattern": "^.*$",
        "minLength": 1,
        "maxLength": 24
      }
    }
  }
}