Skip to main content
GET
/
usage-metrics
List all Usage Metrics
curl --request GET \
  --url https://eu.sequencehq.com/api/usage-metrics \
  --header 'Authorization: <authorization>'
{
  "items": [
    {
      "id": "f092246c-6b90-4106-bcca-304ccf06bf45",
      "sequenceAccountId": "ec1479a2-6ba1-421f-a7de-0853a20d17a1",
      "name": "Total length of sent messages.",
      "description": "Total length of sent messages.",
      "metricType": "GROUPED",
      "eventType": "message_sent",
      "aggregationType": "COUNT",
      "aggregationProperty": "message_length",
      "groupingProperty": "channel",
      "unit": "bytes",
      "createdAt": "2022-06-28T16:47:00Z",
      "deletedAt": "2022-06-28T16:47:00Z",
      "propertyFilters": {
        "channels": [
          "text",
          "email"
        ]
      },
      "caseSensitive": true,
      "propertiesToNegate": [
        "channels"
      ],
      "parameters": [
        {
          "id": "2963e49a-c8e0-4673-89f5-7a805c0faf14",
          "usageMetricId": "f092246c-6b90-4106-bcca-304ccf06bf45",
          "name": "myParam",
          "type": "INTEGER",
          "description": "My parameter",
          "defaultValue": "10"
        }
      ]
    }
  ],
  "pagination": {
    "after": "MDE4NDUyNjYtNmQ2NC03N2M4LTlhZGYtNDQ4N2Q5NGQxNDU3",
    "before": "MDE4NDQyMWUtYTljYy03MTFiLWFmOTMtYmYwNTExZDRkODMz",
    "totalResultSize": 10
  }
}

Headers

​
Authorization
string
required

Your API credentials. Eg. Basic {credentials}.

​
Sequence-Version
enum<string>

Use this header to select an API version

Available options:
2024-07-30

Query Parameters

​
limit
integer

Maximum number of objects to return per-page. Must be between 1 and 100 (inclusive).

​
after
string

Pagination offset. To page through items, omit this parameter to retrieve the first page, and then successively use the value you get from pagination.after or pagination.before to retrieve each page.

​
before
string

Pagination offset. To page through items, omit this parameter to retrieve the first page, and then successively use the value you get from pagination.next or pagination.previous to retrieve each page.

Response

OK

​
items
object[]
required

Usage metrics

Example:
[
  {
    "id": "f092246c-6b90-4106-bcca-304ccf06bf45",
    "sequenceAccountId": "ec1479a2-6ba1-421f-a7de-0853a20d17a1",
    "name": "Total length of sent messages.",
    "description": "Total length of sent messages.",
    "metricType": "GROUPED",
    "eventType": "message_sent",
    "aggregationType": "COUNT",
    "aggregationProperty": "message_length",
    "groupingProperty": "channel",
    "unit": "bytes",
    "createdAt": "2022-06-28T16:47:00Z",
    "deletedAt": "2022-06-28T16:47:00Z",
    "propertyFilters": { "channels": ["text", "email"] },
    "caseSensitive": true,
    "propertiesToNegate": ["channels"],
    "parameters": [
      {
        "id": "2963e49a-c8e0-4673-89f5-7a805c0faf14",
        "usageMetricId": "f092246c-6b90-4106-bcca-304ccf06bf45",
        "name": "myParam",
        "type": "INTEGER",
        "description": "My parameter",
        "defaultValue": "10"
      }
    ]
  }
]
​
pagination
object
required

Results pagination

Example:
{
  "after": "MDE4NDUyNjYtNmQ2NC03N2M4LTlhZGYtNDQ4N2Q5NGQxNDU3",
  "before": "MDE4NDQyMWUtYTljYy03MTFiLWFmOTMtYmYwNTExZDRkODMz",
  "totalResultSize": 10
}