List Attributes
You can use the Export API to list Insights account or user attributes.
The Export API does not return archived account or user attributes.
The account attributes returned by the Export API are exactly the account attributes listed in the Insights user interface under Settings > Manage Account Attributes & Metrics.
The user attributes returned by the Export API are exactly the user attributes listed in the Insights user interface under Settings > Manage User Attributes & Metrics.
Prerequisites
Before you can list Insights attributes, you must have obtained the export token for your Insights stream.
Submit a request at Zuora Global Support if you do not know the export token for your Insights stream, or if you would like Zuora to generate a new export token for your Insights stream. Zuora Global Support will send the export token to a confirmed Insights administrator. See Global Support Scope for Insights for more information.
If you request a new export token, the previous export token will no longer be honored.
The export token for your Insights stream is different from the stream token that enables you to embed Insights account profiles in your application.
Request
GET https://nw1.api.insights.zuora.com/api/export/attributes/{type}
Request URL Fields
Specify the following fields in the request URL.
| type | required |
The type of attributes to list. One of the following values:
|
Request Header Fields
Specify the following fields in the request header.
| Authorization | required |
HTTP Basic Authorization header. The Basic Authorization username is the export token for your Insights stream. The Basic Authorization password is the empty string. |
Request Body Fields
None.
Response
The response body contains a JSON array of account or user attributes.
Examples
Example Request (cURL)
curl -X GET --user your_export_token: \ 'https://nw1.api.insights.zuora.com/api/export/attributes/ACCOUNT'
Example Success Response (JSON)
[ "total_past_cancels", "contracted_mrr", "todays_mrr", "min_renewal_term_months", "max_renewal_term_months", "account_balance", ... ]