Book a demo

list_report_opens

List my report opens

read collection tenant-private since 2026-10-01

Lists how often the caller opened each report in an org over the last 90 days, most opened first, then by report name: one item per report opened, with its count and when it was last opened. Only the caller's own opens (record_report_open), never anyone else's. The Reports list is ordered by it, after the reports of the tab the person is on.

Contract

shape
collection
authority
read
evidence
none
subscription
false
permission
any one of: org.member (carried by the caller's role template in the org `org_id`); a deactivated caller is refused first
idempotency
safe
emits
none
MCP tool
list_report_opens
REST
POST https://api.containertradehq.com/v1/cap/list_report_opens

Idempotency: a read: calling again changes nothing

Inputs

nametyperequiredvalidation
org_idorg_idrequiredtradehq-org-id; 1 to 20 characters
The org the reports were opened in.

Paginated: next next_after · page_max 13 · walk_max 13 · ceiling declared

Response

  • items · object[]
  • next_after · stringnull · Pass as `after` for the next page; null on the last one.
Full JSON Schema 
{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "report": {
            "type": "string",
            "enum": [
              "available_to_promise",
              "yard_fees_by_unit",
              "yard_monthly_fees",
              "sourced_overall",
              "sourced_by_supplier",
              "orders_overall",
              "orders_by_customer",
              "activity_log",
              "inventory_audit",
              "failed_comms",
              "depot_inventory",
              "asset_inventory",
              "cash_flow_audit"
            ],
            "description": "The report.",
            "x-data-class": "operational"
          },
          "opens": {
            "type": "integer",
            "description": "How many times the caller opened it in the last 90 days, at least one.",
            "x-data-class": "operational"
          },
          "last_opened_at": {
            "type": "string",
            "format": "date-time",
            "description": "When the caller last opened it.",
            "x-data-class": "operational"
          }
        },
        "required": [
          "report",
          "opens",
          "last_opened_at"
        ],
        "additionalProperties": false
      },
      "maxItems": 13
    },
    "next_after": {
      "type": [
        "string",
        "null"
      ],
      "description": "Pass as `after` for the next page; null on the last one."
    }
  },
  "required": [
    "items",
    "next_after"
  ],
  "additionalProperties": false
}

Refusals

The platform refusals apply to every call: version, authentication, authority, validation and rate limits, each in the same envelope.

Surfaces

DesktopF
MobileF
APIF
MCPF
VoiceD4
PushN
OneBoxN
OutboundN
  • Voice: degraded: visualization
  • Push: emits nothing
  • OneBox: no document originates a report open
  • Outbound: a read emits nothing

Events

None emitted.

Related

None.