Placewise API
Get startedExplore
Get startedExplore
Performance Cloud 🗗
Placewise 🗗
ExplorePublic APIManagement APIUsers APIOperations APIMessaging APIReporting API
ML APIData API
ExplorePublic APIManagement APIUsers APIOperations APIMessaging APIReporting API
ML APIData API
  1. Sendings
  • Introduction
  • Filter parameter specification
  • Data formats
    • Records
    • Timeseries
  • Reports
    • Members
      • members (records)
      • members_count (records)
      • members_grouped_count (records)
      • member_balance (timeseries)
      • members_count_snapshot (timeseries)
      • members_count_history (timeseries)
    • Sendings
      • sendings (records)
      • sendings_events_history (timeseries)
      • sendings_recipients_statistics (timeseries)
      • sendings_links (records)
      • sendings_links_stats (records)
      • Examples
        • sendings - find sending by reporting_id
        • sendings_events_history - show sending events
        • sendings_recipients_statistics - show recipients by age groups
    • Links
      • links_visits_history (timeseries)
  • Geo API
    • Find Locations Coordinates
      POST
    • List places
      POST
    • Show place
      GET
  • Metadata
    POST
  • Field metadata
    POST
  • Query (records)
    POST
  • Query (timeseries)
    POST
  • Query (records) export
    POST
  • Query (timeseries) export
    POST
  • Tenants query (records) export
    POST
  • Tenants query (timeseries) export
    POST
  1. Sendings

sendings_recipients_statistics (timeseries)

Required permitRate limit tokens costAvailable intervals
Reporting:Api:Report:SendingsRecipientsStatistics31h, 1d, 1w, 1mo
This report allows you to get information about sending recipients.

Fields#

loyalty_club_id#

TypeFilterable
Integer (via X-Customer header)
ID of loyalty club.

sending_id#

TypeFilterable
Integer
Internal ID of sending.

gender#

TypeFilterable
Enum
Gender of member. See members report.

age#

TypeFilterable
Enum
Age group of member. See members report.

place_id#

TypeFilterable
Integer
Place ID (location) of member. See members report.

Query without aggregations#

Query returns series with numbers of recipients to which sending was sent.
{
    "interval": "1h",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00"
    ],
    "series": [
        {
            "label": {},
            "values": [
                51,
                50,
                60,
                38,
                40,
                28
            ]
        }
    ],
    "data_points": 6,
    "result_type": "timeseries"
}

Aggregations#

sending_id#

Fetch recipients aggregated by sending ID.

Labels#

KeyTypeDescription
sending_idIntegerSee in Fields

Example query response#

{
    "interval": "1h",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00"
    ],
    "series": [
        {
            "label": {
                "sending_id": 15235
            },
            "values": [
                45,
                42,
                48,
                30,
                37,
                26
            ]
        },
        {
            "label": {
                "sending_id": 15432
            },
            "values": [
                3,
                3,
                2,
                3,
                1,
                null
            ]
        }
    ],
    "data_points": 11,
    "result_type": "timeseries"
}

gender#

Fetch recipients aggregated by gender.

Labels#

KeyTypeDescription
genderEnumSee in Fields

Example query response#

{
    "interval": "1h",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00"
    ],
    "series": [
        {
            "label": {
                "gender": "man"
            },
            "values": [
                7,
                4,
                13,
                7,
                7,
                6
            ]
        },
        {
            "label": {
                "gender": "woman"
            },
            "values": [
                36,
                37,
                42,
                28,
                33,
                22
            ]
        }
    ],
    "data_points": 12,
    "result_type": "timeseries"
}

age#

Fetch recipients aggregated by age group.

Labels#

KeyTypeDescription
ageEnumSee in Fields

Example query response#

{
    "interval": "1h",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00"
    ],
    "series": [
        {
            "label": {
                "age": "15-19"
            },
            "values": [
                1,
                null,
                1,
                1,
                1,
                2
            ]
        },
        {
            "label": {
                "age": "20-24"
            },
            "values": [
                1,
                3,
                1,
                1,
                1,
                3
            ]
        }
    ],
    "data_points": 11,
    "result_type": "timeseries"
}

place_id#

Fetch recipients aggregated by place_id (location).

Labels#

KeyTypeDescription
place_idIntegerSee in Fields

Example query response#

{
    "interval": "1h",
    "range_timezone": "Europe/Oslo",
    "time_buckets": [
        "2025-08-27T10:00:00.000+02:00",
        "2025-08-27T11:00:00.000+02:00",
        "2025-08-27T12:00:00.000+02:00",
        "2025-08-27T13:00:00.000+02:00",
        "2025-08-27T14:00:00.000+02:00",
        "2025-08-27T15:00:00.000+02:00"
    ],
    "series": [
        {
            "label": {
                "place_id": 20355
            },
            "values": [
                1,
                1,
                null,
                null,
                null,
                null
            ]
        },
        {
            "label": {
                "place_id": 24137
            },
            "values": [
                1,
                null,
                null,
                null,
                2,
                1
            ]
        }
    ],
    "data_points": 5,
    "result_type": "timeseries"
}
Previous
sendings_events_history (timeseries)
Next
sendings_links (records)
Built with