Ambassadors of the brand's ambassador programs
GET
/api/public/v1/stats/ambassadorsLiveAnswers from your brand's records now.
Operation id getAmbassadors
Request
curl
curl "https://creator.growthdept.ai/api/public/v1/stats/ambassadors" \
-H "Authorization: Bearer gdc_..."Parameters
| Name | In | Type | Notes |
|---|---|---|---|
| require_application | query | string | Default true |
| page | query | integer | Default 1 |
| per_page | query | integer | Default 20 |
| query | string | ||
| first_name | query | string | |
| last_name | query | string | |
| search | query | string | |
| approved_at_from | query | string (date) | |
| approved_at_to | query | string (date) | |
| campaign_id | query | integer |
Responses
200Success
| Field | Type | Notes |
|---|---|---|
| data | array of object | |
| data[].[].approved_at | string (date-time) | |
| data[].[].campaign_affiliate_id | integer | |
| data[].[].campaign_id | integer | |
| data[].[].campaign_name | string | |
| data[].[].custom_field_answers | array of object | |
| data[].[].custom_field_answers[].[].answer | string | |
| data[].[].custom_field_answers[].[].field_type | string | |
| data[].[].custom_field_answers[].[].question | string | |
| data[].[].email | string | |
| data[].[].first_name | string | |
| data[].[].joined_at | string | |
| data[].[].last_name | string | |
| data[].[].name | string | |
| data[].[].social_accounts | array of object | |
| data[].[].social_accounts[].[].platform | string | |
| data[].[].social_accounts[].[].profile_share_url | string | |
| data[].[].social_accounts[].[].username | string | |
| data[].[].user_id | integer | |
| data[].[].user_location | string | |
| data[].[].user_phone_number | string, nullable | |
| meta | object | |
| meta.current_page | integer | |
| meta.per_page | integer | |
| meta.total_ambassadors | integer | |
| meta.total_pages | integer |
Example
{
"data": [
{
"approved_at": "2026-11-01T15:04:05Z",
"campaign_affiliate_id": 1024,
"campaign_id": 1024,
"campaign_name": "Example name",
"custom_field_answers": [
{
"answer": "string",
"field_type": "string",
"question": "string"
}
],
"email": "creator@example.com",
"first_name": "Example name",
"joined_at": "2026-11-01T15:04:05Z",
"last_name": "Example name",
"name": "Example name",
"social_accounts": [
{
"platform": "string",
"profile_share_url": "https://example.com/p/1",
"username": "Example name"
}
],
"user_id": 1024,
"user_location": "string",
"user_phone_number": "string"
}
],
"meta": {
"current_page": 1,
"per_page": 1,
"total_ambassadors": 3,
"total_pages": 1
}
}Errors: 400401with an error and usually a message. See errors.
Example values are made up from each field's type and name.