Contacts
Retrieve contacts
API Documentation
Contacts
Contacts
Retrieve contacts
Returns a paginated list of stored contacts in the mailing list.
GET
/
contacts
curl --request GET \
--url https://api.indiepitcher.com/v1/contacts
{
"success": true,
"data": [
{
"email": "john@acme.com",
"userId": 123456,
"name": "John Doe",
"avatarUrl": "https://example.com/profile_pictures/123456",
"languageCode": "en-US",
"hardBouncedAt": "2024-04-23T18:25:43.511Z",
"subscribedToLists": [
"onboarding",
"newsletter"
],
"customProperties": {
"company": "Acme",
"age": 35
}
}
],
"metadata": {
"page": 1,
"per": 10,
"total": 1023
}
}
Query Parameters
Page to fetch, the first page has index 1.
How many contacts to return per page.
Response
200 - application/json
A paginated list of contacts
The email of the contact.
The user id of the contact.
The full name of the contact
The avatar url of the contact
The primary language language of this contact, represented by a language code.
The date when an attempt to send an email to the contact failed with a hard bounce, meaning the email address is invalid and no further emails will be send to this contact. You can reset this in the dashboard to re-enable sending emails to this contact.
The array of mailing lists the contact is subscribed to.
curl --request GET \
--url https://api.indiepitcher.com/v1/contacts
{
"success": true,
"data": [
{
"email": "john@acme.com",
"userId": 123456,
"name": "John Doe",
"avatarUrl": "https://example.com/profile_pictures/123456",
"languageCode": "en-US",
"hardBouncedAt": "2024-04-23T18:25:43.511Z",
"subscribedToLists": [
"onboarding",
"newsletter"
],
"customProperties": {
"company": "Acme",
"age": 35
}
}
],
"metadata": {
"page": 1,
"per": 10,
"total": 1023
}
}