Skip to main content
Including metadata, current owner, and blockchain details.

​
Prerequisites

  • Valid API key with token read permissions
  • Valid token ID

​
Request

curl -X GET "https://api.g2cplatform.com/v2/tokens/token_abc123..." \
  -H "X-API-Key: your-api-key"

​
Path Parameters

ParameterTypeRequiredDescription
tokenIdstringYesUnique token identifier

​
Response

{
  "tokenId": "token_abc123...",
  "tokenType": "NFT",
  "walletAddress": "0x1234567890abcdef...",
  "metadata": {
    "name": "Digital Certificate",
    "description": "Certificate of completion for Blockchain Fundamentals course",
    "image": "https://example.com/certificate.png",
    "attributes": [
      {
        "trait_type": "Course",
        "value": "Blockchain Fundamentals"
      },
      {
        "trait_type": "Level",
        "value": "Beginner"
      },
      {
        "trait_type": "Date Issued",
        "value": "2025-01-15"
      }
    ]
  },
  "blockchain": {
    "network": "ethereum",
    "contractAddress": "0xabcdef123456...",
    "tokenStandard": "ERC-721",
    "blockNumber": 18500000,
    "transactionHash": "0xfedcba987654..."
  },
  "status": "active",
  "createdAt": "2025-01-15T10:30:00Z",
  "lastTransferAt": "2025-01-15T14:20:00Z",
  "transferCount": 2
}

​
Response Fields

FieldTypeDescription
tokenIdstringUnique token identifier
tokenTypestringToken type: “FUNGIBLE” or “NFT”
walletAddressstringCurrent owner wallet address
amountnumberToken amount (for fungible tokens only)
metadataobjectToken metadata
blockchainobjectBlockchain-specific information
statusstringToken status: “active”, “transferred”, “burned”
createdAtstringISO 8601 timestamp of token creation
lastTransferAtstringISO 8601 timestamp of last transfer (null if never transferred)
transferCountnumberTotal number of transfers

​
Metadata Object

For NFTs:
FieldTypeDescription
namestringNFT name
descriptionstringNFT description
imagestringURL to NFT image
attributesarrayArray of trait objects
For Fungible Tokens:
FieldTypeDescription
namestringToken name
symbolstringToken symbol
decimalsnumberNumber of decimal places
descriptionstringToken description

​
Blockchain Object

FieldTypeDescription
networkstringBlockchain network (e.g., “ethereum”, “polygon”)
contractAddressstringSmart contract address
tokenStandardstringToken standard (ERC-721, ERC-20, etc.)
blockNumbernumberBlock number of creation transaction
transactionHashstringCreation transaction hash

​
Token Status

StatusDescription
activeToken is active and can be transferred
transferredToken has been transferred to another wallet
burnedToken has been permanently destroyed

​
Error Responses

Status CodeDescription
400Invalid token ID format
401Unauthorized - invalid API key
403Insufficient permissions
404Token not found
500Internal server error

​
Use Cases

  • Token Verification: Verify token authenticity and ownership
  • Metadata Display: Show token details in applications
  • Ownership Tracking: Check current token owner
  • Audit Trail: Access blockchain transaction details
  • Integration: Retrieve token data for external systems