Embedded Tax API

Reports

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

GET

/users/{referenceId}/reports

List a user's reports

Status	Meaning
`200`	Available and in-progress reports
`404`	The resource was not found for the authenticated partner

curl

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

POST

/users/{referenceId}/reports

Generate a tax report

Field	Type	Required	Notes
`year`	integer	Yes	min 2020
`reportType`	string	Yes
`email`	string	No	email

Request body

{
  "year": 2025,
  "reportType": "tax-forms",
  "email": "user@example.com"
}

Status	Meaning
`201`	Report generation accepted
`400`	Validation failed

curl

curl -X POST "https://api.awaken.tax/api/users/:referenceId/reports" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json" \
  --data '{ "year": 2025, "reportType": "tax-forms", "email": "user@example.com" }'

GET

/users/{referenceId}/reports/{reportId}/download

Download a generated report

Status	Meaning
`200`	Report file
`404`	The resource was not found for the authenticated partner

curl

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

POST

/users/{referenceId}/reports/{reportId}/download

Download a report with a signed payload

Status	Meaning
`200`	Report file
`401`	Invalid or expired signature

curl

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

POST

/reports/{reportId}/download

Retrieve report data through a signed download

Status	Meaning
`200`	Base64 report data and filename
`401`	Invalid or expired signature
`404`	The resource was not found for the authenticated partner

curl

curl -X POST "https://api.awaken.tax/api/reports/:reportId/download" \
  -H "x-client-id: $AWAKEN_CLIENT_ID" \
  -H "x-api-secret: $AWAKEN_API_SECRET" \
  -H "content-type: application/json"