Skip to main content
GET
/
tags
Python
from dub import Dub


with Dub(
    token="DUB_API_KEY",
) as d_client:

    res = d_client.tags.list(request={
        "page": 1,
        "page_size": 50,
    })

    # Handle response
    print(res)
declare(strict_types=1);

require 'vendor/autoload.php';

use Dub;
use Dub\Models\Operations;

$sdk = Dub\Dub::builder()
->setSecurity(
'DUB_API_KEY'
)
->build();

$request = new Operations\GetTagsRequest(
page: 1,
pageSize: 50,
);

$response = $sdk->tags->list(
request: $request
);

if ($response->linkTagSchemaOutputs !== null) {
// handle response
}
package main

import(
"context"
dubgo "github.com/dubinc/dub-go"
"github.com/dubinc/dub-go/models/operations"
"log"
)

func main() {
ctx := context.Background()

s := dubgo.New(
dubgo.WithSecurity("DUB_API_KEY"),
)

res, err := s.Tags.List(ctx, operations.GetTagsRequest{
Page: dubgo.Pointer[float64](1.0),
PageSize: dubgo.Pointer[float64](50.0),
})
if err != nil {
log.Fatal(err)
}
if res != nil {
// handle response
}
}
require 'dub'

Models = ::OpenApiSDK::Models
s = ::OpenApiSDK::Dub.new(
security: Models::Shared::Security.new(
token: 'DUB_API_KEY'
)
)

req = Models::Operations::GetTagsRequest.new(
page: 1.0,
page_size: 50.0
)
res = s.tags.list(request: req)

unless res.nil?
# handle response
end
import { Dub } from "dub";

const dub = new Dub({
token: "DUB_API_KEY",
});

async function run() {
const result = await dub.tags.list();

console.log(result);
}

run();
curl --request GET \
--url https://api.dub.co/tags \
--header 'Authorization: Bearer <token>'
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.dub.co/tags', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
HttpResponse<String> response = Unirest.get("https://api.dub.co/tags")
.header("Authorization", "Bearer <token>")
.asString();
[
  {
    "id": "<string>",
    "name": "<string>"
  }
]
{
"error": {
"code": "bad_request",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#bad-request"
}
}
{
"error": {
"code": "unauthorized",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#unauthorized"
}
}
{
"error": {
"code": "forbidden",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#forbidden"
}
}
{
"error": {
"code": "not_found",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#not-found"
}
}
{
"error": {
"code": "conflict",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#conflict"
}
}
{
"error": {
"code": "invite_expired",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#invite-expired"
}
}
{
"error": {
"code": "unprocessable_entity",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#unprocessable-entity"
}
}
{
"error": {
"code": "rate_limit_exceeded",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#rate-limit_exceeded"
}
}
{
"error": {
"code": "internal_server_error",
"message": "The requested resource was not found.",
"doc_url": "https://dub.co/docs/api-reference/errors#internal-server_error"
}
}

Authorizations

Authorization
string
header
required

Default authentication mechanism

Query Parameters

sortBy
enum<string>
default:name

The field to sort the tags by.

Available options:
name,
createdAt
sortOrder
enum<string>
default:asc

The order to sort the tags by.

Available options:
asc,
desc

The search term to filter the tags by.

ids

IDs of tags to filter by.

page
number

The page number for pagination.

Required range: x > 0
Example:

1

pageSize
number
default:100

The number of items per page.

Required range: 0 < x <= 100
Example:

50

Response

A list of tags

id
string
required

The unique ID of the tag.

name
string
required

The name of the tag.

color
enum<string>
required

The color of the tag.

Available options:
red,
yellow,
green,
blue,
purple,
brown,
gray,
pink