Custom Audience Health

Updated: May 2, 2025

Reading

This endpoint will expose the aggregated user value data that is shared via Audience API.

Select language

GET /v25.0/{custom-audience-id}/health HTTP/1.1
Host: graph.facebook.com

If you want to learn how to use the Graph API, read our Using Graph API guide

Parameter	Description
`calculated_date` string	The UTC calculated date / click date associated with this information, this will be a string in the format “YYYY-MM-DD” i.e. “2025-01-01”
`processed_date` string	The UTC date on which the data was received, this will be a string in the format “YYYY-MM-DD” i.e. “2025-02-01”
`value_aggregation_duration` int64	The duration over which this value type was calculated
`value_country` string	The country associated to the value field
`value_currency` string	The currency associated to the value field
`value_version` int64	The value version of this calculation (e.g. V1 data, V2 data represented as 1 or 2 respectively)

Reading from this edge will return a JSON formatted result:

{
"data": [],
"paging": {}
}

A list of CustomAudienceHealth nodes.

For more details about pagination, see the Graph API guide.

Error Code	Description
100	Invalid parameter

You can't perform this operation on this endpoint.

You can't perform this operation on this endpoint.

You can't perform this operation on this endpoint.