Phygrid Developers
Browse Topics
Space Reports / Phygrid Developers

Space Reports

Space reports

The following endpoints are available in the API for space reports.

MethodEndpointDescription
GETeventsReturns list of space events based on specified query parameters
GETsessions

Returns list of space sessions based on specified query parameters

GETnpsReturns space nps data
GET

events flow

Returns space events flow data
GET

products events

Returns list of space products events based on specified query parameters

GET

categories events

Returns list of space categories events based on specified query parameters

GET

purchases events

Returns list of space purchases (transactions) events based on specified query parameters

GET

purchased products events

Returns list of space purchased products events based on specified query parameters

GET

qr codes events

Returns list of space qr codes events based on specified query parameters

GET

media events

Returns list of space media events based on specified query parameters

{tenant-id} is your tenant id in the grid console.

{space-id} is your space id in the grid console.

GET Space events

Returns list of space events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/events

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "spaceId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "count": number,
    "sessionCount": number,
    "hour"?: number
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines events interaction type.
Possible values: interactive, nonInteractive, all. Default value: all

interactivefalse
timespanTypestring

Defines events timespan type.
Possible values: day, hour. Default value: day

dayfalse

GET Space sessions

Returns list of space sessions based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/sessions

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "sessionCount": number,
    "date": string,
    "spaceId": string,
    "hour"?: string
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines sessions interaction type.
Possible values: interactive, all. Default value: all

interactivefalse
timespanTypestring

Defines sessions timespan type.
Possible values: day, hour. Default value: day

dayfalse

GET Space nps

Returns space nps data.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/nps

Response

{
  "score": number,
  "replyCount": number
}

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET Space events flow

Returns space events flow data.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/eventsFlow

Response

[
  {
    "count": number,
    "eventType": string,
    "eventTypePrevious"?: string,
    "eventOrder": number
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
eventsFlowDepthnumber

Defines events flow depth. Minimum value: 1. Maximum value: 40. Default value: 15

15false

GET Space products events

Returns list of space products events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/products

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "productId": string,
    "count": number,
    "sessionCount": number,
    "spaceId": string
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true
interactionTypestring

Defines events interaction type.
Possible values: interactive, nonInteractive, all. Default value: all

interactivefalse

GET Space categories events

Returns list of space categories events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/categories

Response

[
  {
    "id": string,
    "type": string,
    "tenantId": string,
    "date": string,
    "eventType": string,
    "interaction": boolean,
    "categoryId": string,
    "count": number,
    "sessionCount": number,
    "spaceId": string
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET Space purchases events

Returns list of space purchases (transactions) events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/purchases

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    eventTime: string;
    interaction: boolean;
    transactionId: string;
    revenue: number;
    currency: string;
    count: number;
    sessionCount: number;
    spaceId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET Space purchased products events

Returns list of space purchased products events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/purchased-products

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    transactionId: string;
    productId: string;
    categoryId: string;
    productName: string;
    currency: string;
    quantity: number;
    price: number;
    count: number;
    sessionCount: number;
    spaceId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET Space qr codes events

Returns list of space qr codes events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/qr-codes

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    qrCodeId: string;
    qrCodeContent: string;
    qrCodeEntryMethod: string;
    qrCodeType: string;
    count: number;
    sessionCount: number;
    spaceId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

GET Space media events

Returns list of space media events based on specified query parameters.

GET {base-url}/v2/report/tenants/{tenant-id}/spaces/{space-id}/media

Response

[
  {
    id: string;
    type: string;
    tenantId: string;
    date: string;
    eventType: string;
    interaction: boolean;
    mediaId: string;
    mediaType: string;
    mediaName: string;
    mediaTags: string[];
    mediaDuration: number;
    count: number;
    sessionCount: number;
    spaceId: string;
  }
]

Query Parameters

To use query parameters, add them as GET properties to the URL.

ParameterTypeDescriptionExampleRequired
dateFromstringDefines the starting date2022-12-26true
dateTostringDefines the final date2023-01-02true

© 2024 · Phygrid. An Ombori company