Amazing Fields API Reference and Data Schema
This article documents the data format returned by the Amazing Fields API, explains how Amazing Fields data is embedded in the standard Trello API response, and provides guidance for developers building integrations against the API.
Before using the API, you need to allocate an API token from the Board Settings tab in Amazing Fields. See: Using the Amazing Fields REST API.
How Amazing Fields Data Is Stored
All Amazing Fields data lives on the Trello servers, there is no separate Amazing Fields database. To maximise storage efficiency within Trello’s per-card and per-board limits, Amazing Fields compresses and encodes its data before storing it in Trello’s Power-Up data fields.
The API decodes this automatically, so you receive clean, readable field values in the response. You do not need to handle the encoding yourself.
Warning: The Amazing Fields data schema is not guaranteed to be fully stable across versions.
While stability is a goal, the embedded Amazing Fields portion of the response may change in future updates, particularly as new field types are added or the storage format is optimised. Build your integration defensively and verify against the live API response rather than relying solely on documentation.
Response Structure
The Amazing Fields API returns standard Trello board and card data (matching the structure described in the Trello REST API documentation) with Amazing Fields data embedded alongside it. The key additions to the standard Trello response are:
- Decoded Amazing Fields field values for each card
- Field configuration metadata (field type, display settings, ordering)
- Expanded identifier fields with a _str suffix where applicable, providing readable versions of encoded identifiers
Authentication
Include your API token as a query parameter or request header with every request. The token is tied to your Trello user account and scopes access to boards you have permission to view.
If you have a use case that the current API does not support, contact support@amazingpowerups.com with details. The API is actively developed and feature requests are considered.