POST/reports/list

List reports

Returns a cursor-paginated page of immutable reports from the requested project.

Send request

Use the documented inputs to call this endpoint directly.

API serverbase URL

Request body

application/jsonrequired

Responses

200application/json

Report page.

{
  "status": "success",
  "data": {
    "reports": [
      {
        "id": "65f0c7a9a7d6b4e2c1234567",
        "org_id": "65f0c7a9a7d6b4e2c1234567",
        "title": "string",
        "description": "string",
        "locale": "en",
        "time_range": {
          "from": "2026-01-01T00:00:00Z",
          "to": "2026-01-01T00:00:00Z"
        },
        "scope": {
          "type": "all_checks"
        },
        "status": "pending",
        "summary": {},
        "html_size_bytes": 1,
        "pdf_size_bytes": 1,
        "pdf_sha256": "string",
        "pdf_rendered_at": "2026-01-01T00:00:00Z",
        "pdf_attempts": 1,
        "pdf_error": "string",
        "created_at": "2026-01-01T00:00:00Z"
      }
    ]
  },
  "pagination": {
    "limit": 1,
    "has_more": true,
    "next_cursor": {
      "after_id": "65f0c7a9a7d6b4e2c1234567",
      "after_value": "2026-01-01T00:00:00Z"
    },
    "filter_scan_truncated": true
  },
  "sort": "string",
  "filters": {
    "title": "string",
    "scope_type": "all_checks",
    "status": "pending",
    "created_from": "2026-01-01T00:00:00Z",
    "created_to": "2026-01-01T00:00:00Z",
    "schedule_id": "65f0c7a9a7d6b4e2c1234567"
  }
}

400application/json

The request body, parameter, filter, cursor, or project-scoping pattern is invalid.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}

statusstringrequired

messagestringrequired

codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional

quotaoptional

featurestringoptional

dependencystringoptional

401application/json

Authentication is missing or the credential is invalid, inactive, expired, or lacks the required scope.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}

statusstringrequired

messagestringrequired

codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional

quotaoptional

featurestringoptional

dependencystringoptional

403application/json

The authenticated caller is not allowed to perform this operation.

{
  "status": "error",
  "message": "string",
  "code": "string",
  "detail": {},
  "quota": {
    "key": "string",
    "limit": 1,
    "used": 1
  },
  "feature": "string",
  "dependency": "string"
}

statusstringrequired

messagestringrequired

codestringoptional

Stable machine-readable code when the error defines one.

detailobjectoptional

quotaoptional

featurestringoptional

dependencystringoptional