Pakt

Common Workflows

Authenticate

curl -s -X POST "$PAKT_BASE_URL/v1/auth/login" \
  -H "Content-Type: application/json" \
  -d '{"email":"EMAIL","password":"PASSWORD"}'
# Returns: data.token → save as PAKT_API_KEY

Create Escrow

curl -s -X POST "$PAKT_BASE_URL/v1/escrow/initiate" \
  -H "Authorization: $PAKT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Project Payment",
    "description": "Payment for deliverable X",
    "amount": 100,
    "coin": "usdc",
    "dueDate": "2026-12-31",
    "isPrivate": false,
    "isFundingRequest": false,
    "receiverId": "RECEIVER_USER_ID"
  }'
# Returns: collectionId, contractAddress, amountToPay

Release Escrow

curl -s -X POST "$PAKT_BASE_URL/v1/escrow/release" \
  -H "Authorization: $PAKT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"escrowId": "ESCROW_ID"}'

Check Wallet

curl -s -H "Authorization: $PAKT_API_KEY" "$PAKT_BASE_URL/v1/wallet"
# Returns: totalBalance (USD), wallets[] with coin/amount/address

Upload File

curl -s -X POST "$PAKT_BASE_URL/v1/upload" \
  -H "Authorization: $PAKT_API_KEY" \
  -F "file=@/path/to/file.png"
# Returns: data.url (CDN URL), data._id

Supported Coins

Avalanche testnet (chain ID: 43113). Common coins: usdc, avax. Run GET /v1/payment/coins for the full list with contract addresses.

Notes

• Auth token is long-lived (no automatic refresh needed in most cases)
• Escrow flow: initiate → fund (on-chain) → validate → release
• File uploads go to CloudFront CDN; url in response is immediately accessible
• Chainsites need to be deployed & activated in the Pakt Command Center before API access works
• API key comes from the Control Panel tab in the Pakt Command Center (PCC)

Full API Reference

See references/api-reference.md for detailed request/response schemas. See references/escrow-flow.md for the complete escrow lifecycle with examples.