Get Token

curl --request GET \
  --url https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

GET

tokensets

{id}

modes

{modeId}

tokens

{tokenId}

Get Token

curl --request GET \
  --url https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://app.tokencraft.dev/api/v1/tokensets/{id}/modes/{modeId}/tokens/{tokenId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

Get Token

Retrieves a specific design token by its unique identifier within a mode.

Endpoint

GET /tokensets/{id}/modes/{modeId}/tokens/{tokenId}

Request

Path Parameters

Parameter	Type	Required	Description
`id`	string	Yes	Tokenset ID
`modeId`	string	Yes	Mode ID
`tokenId`	string	Yes	Token ID returned by the list tokens endpoints

To look up a tokenId, call List Tokens or Get Tokenset Tokens and use the id field from the response.

Response

Status: 200 OK

{
  "id": "token-1",
  "tokenset_id": "tokenset-123",
  "mode_id": "mode-light",
  "name": "colors.primary.500",
  "type": "color",
  "value": "#3b82f6",
  "description": "Primary brand color",
  "alias_to": null,
  "resolved_value": "#3b82f6",
  "created_at": "2025-01-15T10:00:00Z",
  "updated_at": "2025-01-15T10:00:00Z"
}

Special Fields

Field	Description
`resolved_value`	If token is an alias, this contains the final resolved value
`alias_to`	If set, this token references another token

Token with Alias

{
  "name": "colors.button.primary",
  "type": "color",
  "value": null,
  "alias_to": "colors.primary.500",
  "resolved_value": "#3b82f6"
}

Examples

curl -H "Authorization: Bearer tkc_your_token_here" \
  "https://app.tokencraft.dev/api/v1/tokensets/tokenset-123/modes/mode-light/tokens/token-1"

const tokensetId = 'tokenset-123';
const modeId = 'mode-light';
const tokenId = 'token-1';

const response = await fetch(
  `https://app.tokencraft.dev/api/v1/tokensets/${tokensetId}/modes/${modeId}/tokens/${tokenId}`,
  {
    headers: {
      'Authorization': `Bearer ${process.env.TOKENCRAFT_TOKEN}`
    }
  }
);

const token = await response.json();
console.log(`${token.name}: ${token.resolved_value || token.value}`);

import requests

tokenset_id = 'tokenset-123'
mode_id = 'mode-light'
token_id = 'token-1'

response = requests.get(
    f'https://app.tokencraft.dev/api/v1/tokensets/{tokenset_id}/modes/{mode_id}/tokens/{token_id}',
    headers={'Authorization': f'Bearer {token}'}
)

token = response.json()
print(f"{token['name']}: {token.get('resolved_value', token['value'])}")

Error Responses

404 Not Found

{
  "error": "Token not found"
}

Causes:

Token ID doesn’t exist in this mode
Token was deleted
Token belongs to a different tokenset or mode

Use Cases

1. Token Details View

Show full token information:

async function TokenDetails({ tokensetId, modeId, tokenId }) {
  const token = await getToken(tokensetId, modeId, tokenId);
  
  return (
    <div>
      <h2>{token.name}</h2>
      <p>Type: {token.type}</p>
      <p>Value: {token.resolved_value || token.value}</p>
      {token.description && <p>{token.description}</p>}
      {token.alias_to && <p>References: {token.alias_to}</p>}
    </div>
  );
}

2. Token Validation

Check if token exists:

async function tokenExists(tokensetId, modeId, tokenId) {
  try {
    await getToken(tokensetId, modeId, tokenId);
    return true;
  } catch (error) {
    if (error.status === 404) return false;
    throw error;
  }
}

3. Resolve Alias Chain

Follow alias references:

async function resolveToken(tokensetId, modeId, tokenId) {
  const token = await getToken(tokensetId, modeId, tokenId);
  return token.resolved_value || token.value;
}

Next Steps

List All Tokens

Get all tokens in a mode

Export Tokens

Export in multiple formats

List Tokens Create Token

​Get Token

​Endpoint

​Request

​Path Parameters

​Response

​Special Fields

​Token with Alias

​Examples

​Error Responses

​404 Not Found

​Use Cases

​1. Token Details View

​2. Token Validation

​3. Resolve Alias Chain

​Next Steps

List All Tokens

Export Tokens

Get Token

Endpoint

Request

Path Parameters

Response

Special Fields

Token with Alias

Examples

Error Responses

404 Not Found

Use Cases

1. Token Details View

2. Token Validation

3. Resolve Alias Chain

Next Steps