Contacts statistics

Retrieve one

Endpoint

GET https://bulkdroidsms.com/api/contacts-statistics/

Parameters	Details	Description
start_date	Required	Start date in `Y-m-d` format.
end_date	Required	End date in `Y-m-d` format.
type	Optional String	Allowed values: `overview`, `continent_code`, `country_code`, `has_opted_out`

Example

curl --request GET \
--url 'https://bulkdroidsms.com/api/contacts-statistics?start_date=2025-09&end_date=2025-11-06' \
--header 'Authorization: Bearer {api_key}' \

Response example

{
    "data": [
        {
            "contacts": 20,
            "formatted_date": "2025-09"
        },
        {
            "contacts": 35,
            "formatted_date": "2025-10"
        },
        {
            "contacts": 50,
            "formatted_date": "2025-11"
        }
    ]
}