====== API Audience Endpoints ======

===== Get All Audiences =====

This Endpoint is used to get all Audiences in your Sentori Account.

==== Endpoint ====
|URI| <nowiki>https://api.sentoriapp.com/v2.0/audiences/</nowiki>|
|Method| GET |

==== Response ====

|Field| Type|Description |
|ExternalID| string| ID of the Audience.|
|Name|string| Name of the Audience.|
|Description| string| Description of the Audience.|

|Example|<code javascript>
[
	{
		"ExternalID": "1234ABCD",
		"Name": "Staff",
		"Description": "Any contacts with an @mycompany.com address."
	},
	{
		"ExternalID": "ABCD1234",
		"Name": "Our Suppliers",
		"Description": "Contacts with the Suppliers field ticked."
	}
]
</code>|


===== Get Audience Contacts=====

This Endpoint is used to get all the Contacts that match an Audience's criteria and are Emailable (those that are Unsubscribed or marked as having a Bad Email Address are excluded).

You can find the Audience External IDs on the [[/audience|Audience]] page in Sentori or by calling the Get All Audiences API Endpoint.

==== Endpoint ====
|URI| <nowiki>https://api.sentoriapp.com/v2.0/audiences/contacts/{AudienceExternalID}</nowiki>|
|Method| GET |

==== Response ====

|Field| Type|Description |
|SystemID|integer| The SystemID of a Contact.|
|EmailAddress|string| The email address of a Contact.|

|Example|<code javascript>
[
	{
		"SystemID": "1",
		"EmailAddress": "contact1@sentori.co.uk"
	},
	{
		"SystemID": "2",
		"EmailAddress": "contact2@sentori.co.uk"
	},
]
</code>|