Embedded Tax API

Accounts

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

GET

/users/{referenceId}/accounts

List a user's accounts

Status	Meaning
`200`	Compact account list
`404`	The resource was not found for the authenticated partner

curl

curl -X GET "https://api.awaken.tax/api/users/:referenceId/accounts" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json"

POST

/users/{referenceId}/accounts

Add wallet accounts

Field	Type	Required	Notes
`wallets`	array	Yes

Request body

{
  "wallets": [
    {
      "address": "0xabc…",
      "chain": "ethereum",
      "name": "Treasury"
    }
  ]
}

Status	Meaning
`201`	Supported accounts created
`400`	Invalid wallet or 10-account limit reached

curl

curl -X POST "https://api.awaken.tax/api/users/:referenceId/accounts" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "wallets": [ { "address": "0xabc…", "chain": "ethereum", "name": "Treasury" } ] }'

GET

/users/{referenceId}/account_syncs

List account syncs and current account states

Status	Meaning
`200`	Sync jobs and account statuses
`404`	The resource was not found for the authenticated partner

curl

curl -X GET "https://api.awaken.tax/api/users/:referenceId/account_syncs" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json"

POST

/users/{referenceId}/account_syncs

Start account syncs

Field	Type	Required	Notes
`account_ids`	array	No
`accountIds`	array	No

Request body

{
  "account_ids": [
    "4e0761cc-e588-4e72-8dc7-49fd186ef10d"
  ]
}

Status	Meaning
`202`	Syncs accepted
`400`	Validation failed

curl

curl -X POST "https://api.awaken.tax/api/users/:referenceId/account_syncs" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "account_ids": [ "4e0761cc-e588-4e72-8dc7-49fd186ef10d" ] }'

GET

/users/{referenceId}/account_syncs/{syncId}

Retrieve one account sync

Status	Meaning
`200`	Sync progress
`404`	The resource was not found for the authenticated partner

curl

curl -X GET "https://api.awaken.tax/api/users/:referenceId/account_syncs/:syncId" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json"