Embedded Tax API

Partners

Server-to-server partner endpoints under https://api.awaken.tax/api.

POST

/crunch

Create a card-program user and accounts

Field	Type	Required	Notes
`userId`	string	Yes
`email`	string	No	email
`wallets`	array	No

Request body

{
  "userId": "card-user-42",
  "email": "user@example.com",
  "wallets": [
    {
      "address": "0xabc…",
      "provider": "ethereum",
      "name": "Card rewards"
    }
  ]
}

Status	Meaning
`201`	User and supported accounts created
`400`	Validation failed

curl

curl -X POST "https://api.awaken.tax/api/crunch" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "userId": "card-user-42", "email": "user@example.com", "wallets": [ { "address": "0xabc…", "provider": "ethereum", "name": "Card rewards" } ] }'

POST

/discount-codes

Create or retrieve a user's discount code

Field	Type	Required	Notes
`referenceId`	string	Yes
`year`	integer	No	min 2009, max 2100

Request body

{
  "referenceId": "user-42",
  "year": 2025
}

Status	Meaning
`200`	Existing code
`201`	Code created
`403`	Secret-key authentication required

curl

curl -X POST "https://api.awaken.tax/api/discount-codes" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "referenceId": "user-42", "year": 2025 }'