Quick Start

curl https://app.toku.com/api/tokuApi/v1/hello \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN"

{
  "message": "Hello World"
}

curl https://app.toku.com/api/tokuApi/v1/listGrants \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN"

[
  {
    "grantID": "550e8400-e29b-41d4-a716-446655440000",
    "grantName": "Q1 2026 Token Grant",
    "grantAmount": 50000,
    "grantStatus": "ACCEPTED",
    "grantAmountInFiat": 25000,
    "grantConfigurationName": "Standard Vesting",
    "vestingStartDate": "2026-01-01T00:00:00.000Z",
    "vestingPeriods": 48,
    "vestingFrequencyType": "MONTHLY",
    "vestingCliffPeriods": 12,
    "vestingCliffPercentage": 25,
    "percentageOfUnitsVested": 16.67,
    "recipientFullName": "Jane Smith",
    "grantDate": "2025-12-15T00:00:00.000Z",
    "tags": ["engineering", "2026"],
    "roleInOrgID": "660e8400-e29b-41d4-a716-446655440001",
    "roleInOrgExternalID": 12345
  }
]

curl -X POST https://app.toku.com/api/tokuApi/v1/addSingleGrant \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "x-role-type: CLIENT_ORG_ADMIN" \
  -H "Content-Type: application/json" \
  -d '{
    "grantName": "New Hire Grant",
    "grantConfigurationID": "YOUR_GRANT_CONFIG_ID",
    "grantAmount": 10000,
    "vestingStartDate": "2026-04-01T00:00:00.000Z",
    "vestingFrequencyType": "MONTHLY",
    "vestingPeriods": 48,
    "vestingCliffPeriods": 12,
    "vestingCliffPercentage": 25,
    "recipientID": "ROLE_IN_ORG_ID",
    "tags": ["new-hire", "2026"]
  }'