Skip to main content
GET
/
tokens
/
{tokenId}
Get API token by ID
curl --request GET \
  --url https://api.lightspark.com/grid/2025-10-13/tokens/{tokenId} \
  --header 'Authorization: Basic <encoded-value>'
{
  "id": "Token:019542f5-b3e7-1d02-0000-000000000001",
  "name": "Sandbox read-only token",
  "permissions": [
    "VIEW"
  ],
  "clientId": "01947d2284054f890000e63bca4810df",
  "clientSecret": "ed0ad25881e234cc28fb2dec0a4fe64e4172",
  "createdAt": "2025-07-21T17:32:28Z",
  "updatedAt": "2025-07-21T17:32:28Z"
}

Authorizations

​
Authorization
string
header
required

API token authentication using format <api token id>:<api client secret>

Path Parameters

​
tokenId
string
required

System-generated unique token identifier

Response

Successful operation

​
id
string
required

System-generated unique identifier

Example:

"Token:019542f5-b3e7-1d02-0000-000000000001"

​
name
string
required

Name of the token

Example:

"Sandbox read-only token"

​
permissions
enum<string>[]
required

A list of permissions granted to the token

​
clientId
string
required

An opaque identifier that should be used as a client_id (or username) in the HTTP Basic Authentication scheme when issuing http requests to Grid.

Example:

"01947d2284054f890000e63bca4810df"

​
createdAt
string<date-time>
required

Creation timestamp

Example:

"2025-07-21T17:32:28Z"

​
updatedAt
string<date-time>
required

Last update timestamp

Example:

"2025-07-21T17:32:28Z"

​
clientSecret
string

The secret that should be used to authenticate against Grid API. This secret is not stored and will never be available again after creation. Platform must keep this secret secure as it grants access to the account.

Example:

"ed0ad25881e234cc28fb2dec0a4fe64e4172"