API reference
DEVELOPER PLATFORM · v1

An API you can build with

CRM, campaigns, analytics and integrations. Exact contracts, practical examples and signed webhooks.

Download OpenAPI

Private preview: use a project API key. Public SLA and support windows have not been established yet.

GET

Get Developer Ticket Analytics

/api/v1/developer/analytics/crm-tickets

Use the access scope below. The generated schemas specify the exact request and responses.

Access scopeanalytics.tickets.read

Authorization: Bearer YOUR_PROJECT_TOKEN

Parameters

periodDaysoptional · query

numberdefault: 30

JSON Schema
{
  "type": "number",
  "default": 30
}

Request examples

curl --request GET   'https://YOUR_NOVA_HOST/api/v1/developer/analytics/crm-tickets?periodDays=30'   --header 'Authorization: Bearer YOUR_PROJECT_TOKEN'

Responses

200 Aggregate CRM ticket analytics
application/json

object

periodDaysrequired
union
Nested schema

union

Variant 1

numberenum: [7]

JSON Schema
{
  "type": "number",
  "enum": [
    7
  ]
}
Variant 2

numberenum: [30]

JSON Schema
{
  "type": "number",
  "enum": [
    30
  ]
}
Variant 3

numberenum: [90]

JSON Schema
{
  "type": "number",
  "enum": [
    90
  ]
}
JSON Schema
{
  "anyOf": [
    {
      "type": "number",
      "enum": [
        7
      ]
    },
    {
      "type": "number",
      "enum": [
        30
      ]
    },
    {
      "type": "number",
      "enum": [
        90
      ]
    }
  ]
}
timeZonerequired
stringminLength: 1 · maxLength: 100
windowrequired
object
Nested schema

object

fromrequired
stringformat: "date-time"
torequired
stringformat: "date-time"
JSON Schema
{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "format": "date-time"
    },
    "to": {
      "type": "string",
      "format": "date-time"
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}
generatedAtrequired
stringformat: "date-time"
projectedThroughrequired
string | nullformat: "date-time"
volumerequired
integerminimum: 0
resolvedrequired
integerminimum: 0
averageResolutionMinutesrequired
number | nullminimum: 0
slarequired
object
Nested schema

object

evaluatedrequired
integerminimum: 0
breachedrequired
integerminimum: 0
breachRaterequired
number | nullminimum: 0 · maximum: 1
JSON Schema
{
  "type": "object",
  "properties": {
    "evaluated": {
      "type": "integer",
      "minimum": 0
    },
    "breached": {
      "type": "integer",
      "minimum": 0
    },
    "breachRate": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 0,
      "maximum": 1
    }
  },
  "required": [
    "evaluated",
    "breached",
    "breachRate"
  ],
  "additionalProperties": false
}
ratingrequired
object
Nested schema

object

countrequired
integerminimum: 0
averagerequired
number | nullminimum: 1 · maximum: 5
JSON Schema
{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 0
    },
    "average": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "count",
    "average"
  ],
  "additionalProperties": false
}
dailyrequired
arraymaxItems: 90
Nested schema

arraymaxItems: 90

object

daterequired
stringformat: "date"
createdrequired
integerminimum: 0
resolvedrequired
integerminimum: 0
ratingsrequired
integerminimum: 0
averageRatingrequired
number | nullminimum: 1 · maximum: 5
JSON Schema
{
  "type": "object",
  "properties": {
    "date": {
      "type": "string",
      "format": "date"
    },
    "created": {
      "type": "integer",
      "minimum": 0
    },
    "resolved": {
      "type": "integer",
      "minimum": 0
    },
    "ratings": {
      "type": "integer",
      "minimum": 0
    },
    "averageRating": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "date",
    "created",
    "resolved",
    "ratings",
    "averageRating"
  ],
  "additionalProperties": false
}
JSON Schema
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "date": {
        "type": "string",
        "format": "date"
      },
      "created": {
        "type": "integer",
        "minimum": 0
      },
      "resolved": {
        "type": "integer",
        "minimum": 0
      },
      "ratings": {
        "type": "integer",
        "minimum": 0
      },
      "averageRating": {
        "type": [
          "number",
          "null"
        ],
        "minimum": 1,
        "maximum": 5
      }
    },
    "required": [
      "date",
      "created",
      "resolved",
      "ratings",
      "averageRating"
    ],
    "additionalProperties": false
  },
  "maxItems": 90
}
JSON Schema
{
  "type": "object",
  "properties": {
    "periodDays": {
      "anyOf": [
        {
          "type": "number",
          "enum": [
            7
          ]
        },
        {
          "type": "number",
          "enum": [
            30
          ]
        },
        {
          "type": "number",
          "enum": [
            90
          ]
        }
      ]
    },
    "timeZone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "window": {
      "type": "object",
      "properties": {
        "from": {
          "type": "string",
          "format": "date-time"
        },
        "to": {
          "type": "string",
          "format": "date-time"
        }
      },
      "required": [
        "from",
        "to"
      ],
      "additionalProperties": false
    },
    "generatedAt": {
      "type": "string",
      "format": "date-time"
    },
    "projectedThrough": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "volume": {
      "type": "integer",
      "minimum": 0
    },
    "resolved": {
      "type": "integer",
      "minimum": 0
    },
    "averageResolutionMinutes": {
      "type": [
        "number",
        "null"
      ],
      "minimum": 0
    },
    "sla": {
      "type": "object",
      "properties": {
        "evaluated": {
          "type": "integer",
          "minimum": 0
        },
        "breached": {
          "type": "integer",
          "minimum": 0
        },
        "breachRate": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 0,
          "maximum": 1
        }
      },
      "required": [
        "evaluated",
        "breached",
        "breachRate"
      ],
      "additionalProperties": false
    },
    "rating": {
      "type": "object",
      "properties": {
        "count": {
          "type": "integer",
          "minimum": 0
        },
        "average": {
          "type": [
            "number",
            "null"
          ],
          "minimum": 1,
          "maximum": 5
        }
      },
      "required": [
        "count",
        "average"
      ],
      "additionalProperties": false
    },
    "daily": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date"
          },
          "created": {
            "type": "integer",
            "minimum": 0
          },
          "resolved": {
            "type": "integer",
            "minimum": 0
          },
          "ratings": {
            "type": "integer",
            "minimum": 0
          },
          "averageRating": {
            "type": [
              "number",
              "null"
            ],
            "minimum": 1,
            "maximum": 5
          }
        },
        "required": [
          "date",
          "created",
          "resolved",
          "ratings",
          "averageRating"
        ],
        "additionalProperties": false
      },
      "maxItems": 90
    }
  },
  "required": [
    "periodDays",
    "timeZone",
    "window",
    "generatedAt",
    "projectedThrough",
    "volume",
    "resolved",
    "averageResolutionMinutes",
    "sla",
    "rating",
    "daily"
  ],
  "additionalProperties": false,
  "$ref": "#/components/schemas/DeveloperTicketAnalyticsResponse"
}
400 Invalid analytics period
application/problem+json

object

type
stringformat: "uri" · default: "about:blank"
titlerequired
string
statusrequired
integerminimum: 100 · maximum: 599
detail
string
instance
string
errors
object
JSON Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri",
      "default": "about:blank"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "errors": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "title",
    "status"
  ]
}
401 Invalid developer credential
application/problem+json

object

type
stringformat: "uri" · default: "about:blank"
titlerequired
string
statusrequired
integerminimum: 100 · maximum: 599
detail
string
instance
string
errors
object
JSON Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri",
      "default": "about:blank"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "errors": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "title",
    "status"
  ]
}
403 Ticket analytics unavailable
application/problem+json

object

type
stringformat: "uri" · default: "about:blank"
titlerequired
string
statusrequired
integerminimum: 100 · maximum: 599
detail
string
instance
string
errors
object
JSON Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri",
      "default": "about:blank"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "errors": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "title",
    "status"
  ]
}
429 Developer API rate limit exceeded
application/problem+json

object

type
stringformat: "uri" · default: "about:blank"
titlerequired
string
statusrequired
integerminimum: 100 · maximum: 599
detail
string
instance
string
errors
object
JSON Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri",
      "default": "about:blank"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "errors": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "title",
    "status"
  ]
}
503 Developer API rate limiter unavailable
application/problem+json

object

type
stringformat: "uri" · default: "about:blank"
titlerequired
string
statusrequired
integerminimum: 100 · maximum: 599
detail
string
instance
string
errors
object
JSON Schema
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "format": "uri",
      "default": "about:blank"
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "minimum": 100,
      "maximum": 599
    },
    "detail": {
      "type": "string"
    },
    "instance": {
      "type": "string"
    },
    "errors": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "title",
    "status"
  ]
}