Signalby Metrics Hive
Start

List reports

GET
/reports

Retrieve a paginated list of all reports, ordered by creation date (newest first).

Requires an instance admin key; organization keys receive 403.

Authorization

BearerAuth
headerAuthorizationBearer <token>

An organization key (signal_…) created under Organization Settings → API Keys.

Query Parameters

page?integer

Page number, 1-based.

Range1 <= value
Default1
limit?integer

Items per page. Values above the maximum are clamped, not rejected.

Range1 <= value <= 100
Default20

Response Body

Paginated list of reports

application/json
  1. response
data*array<>

The items on this page. Read this rather than the named key below.

reports*array<>Deprecated

Deprecated: read data instead. Kept while the one known consumer migrates, and removed in a future release.

pagination*
Example Request
curl -X GET 'https://app.signal.metricshive.com/api/v1/reports'
Example Response
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "brandName": "string",
      "brandAliases": [
        "string"
      ],
      "brandWebsite": "string",
      "status": "pending",
      "createdAt": "2019-08-24T14:15:22Z",
      "completedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "reports": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "brandName": "string",
      "brandAliases": [
        "string"
      ],
      "brandWebsite": "string",
      "status": "pending",
      "createdAt": "2019-08-24T14:15:22Z",
      "completedAt": "2019-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "page": 0,
    "limit": 0,
    "total": 0,
    "totalPages": 0
  }
}