---
updatedAt: 2026-06-02T19:36:30.000Z
agentTools:
  projectIndex: https://docs.conveyor.com/llms.txt
---

# GET Trust Center Conversations

List Trust Center Agent conversations. Returns conversations between customers and the Trust Center AI agent, with nested messages and referenced documents. Use this to understand what prospects are asking during due diligence, which documents the agent recommends, and how conversations flow.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "portal-api",
    "version": "2.0"
  },
  "servers": [
    {
      "url": "https://api.conveyor.com/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v2/trust_center/conversations": {
      "get": {
        "operationId": "getTrustCenterConversations",
        "summary": "GET Trust Center Conversations",
        "description": "List Trust Center Agent conversations. Returns conversations between customers and the Trust Center AI agent, with nested messages and referenced documents. Use this to understand what prospects are asking during due diligence, which documents the agent recommends, and how conversations flow.",
        "parameters": [
          {
            "name": "X-API-KEY",
            "in": "header",
            "required": true,
            "description": "Your Conveyor API key.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "created_at_start",
            "in": "query",
            "required": false,
            "description": "Filter conversations created on or after this date. Format: YYYY-MM-DD.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "created_at_end",
            "in": "query",
            "required": false,
            "description": "Filter conversations created on or before this date. Format: YYYY-MM-DD.",
            "schema": {
              "type": "string",
              "format": "date"
            }
          },
          {
            "name": "include_interactions",
            "in": "query",
            "required": false,
            "description": "Set to \"true\" to include detailed request and response interaction pairs. Default: false.",
            "schema": {
              "type": "string",
              "enum": [
                "true",
                "false"
              ],
              "default": "false"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Page number.",
            "schema": {
              "type": "integer",
              "default": 1,
              "minimum": 1
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "required": false,
            "description": "Results per page.",
            "schema": {
              "type": "integer",
              "default": 100,
              "minimum": 1
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Paginated list of Trust Center Agent conversations.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "required": [
                    "conversations",
                    "page",
                    "per_page",
                    "total_pages"
                  ],
                  "properties": {
                    "conversations": {
                      "type": "array",
                      "description": "List of Trust Center Agent conversations.",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "format": "uuid",
                            "description": "Conversation identifier."
                          },
                          "user_email": {
                            "type": "string",
                            "nullable": true,
                            "description": "Email of the visitor who started the conversation."
                          },
                          "created_at": {
                            "type": "string",
                            "format": "date-time",
                            "description": "When the conversation started."
                          },
                          "messages": {
                            "type": "array",
                            "description": "Chronologically ordered messages.",
                            "items": {
                              "type": "object",
                              "properties": {
                                "message_order": {
                                  "type": "integer",
                                  "description": "Order of the message within the conversation."
                                },
                                "author_role": {
                                  "type": "string",
                                  "description": "Author of the message.",
                                  "enum": [
                                    "User",
                                    "Agent"
                                  ]
                                },
                                "message_content": {
                                  "type": "string",
                                  "description": "Message content."
                                },
                                "created_at": {
                                  "type": "string",
                                  "format": "date-time",
                                  "nullable": true,
                                  "description": "ISO 8601 timestamp of the individual message."
                                },
                                "is_helpful": {
                                  "type": "boolean",
                                  "nullable": true,
                                  "description": "Visitor feedback: true if helpful, false if not helpful, null if no feedback was given."
                                },
                                "feedback": {
                                  "type": "object",
                                  "nullable": true,
                                  "description": "Detailed feedback with category and comment, or null if no feedback was given.",
                                  "properties": {
                                    "category": {
                                      "type": "string",
                                      "description": "Feedback category."
                                    },
                                    "comment": {
                                      "type": "string",
                                      "description": "Feedback comment."
                                    }
                                  }
                                },
                                "documents": {
                                  "type": "array",
                                  "description": "Referenced Trust Center documents.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "id": {
                                        "type": "string",
                                        "format": "uuid",
                                        "description": "Document identifier."
                                      },
                                      "name": {
                                        "type": "string",
                                        "description": "Document name."
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          },
                          "interactions": {
                            "type": "array",
                            "nullable": true,
                            "description": "Detailed request and response interaction pairs. Only included when include_interactions=true.",
                            "items": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "format": "uuid",
                                  "description": "Interaction identifier."
                                },
                                "created_at": {
                                  "type": "string",
                                  "format": "date-time",
                                  "description": "When the interaction was created."
                                },
                                "interaction_types": {
                                  "type": "array",
                                  "description": "Types of agent actions performed in this interaction. Empty array if no tool calls.",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "Answer Question",
                                      "Recommend Documents",
                                      "Retrieve Documents",
                                      "Fill Questionnaire"
                                    ]
                                  }
                                },
                                "answer_confidences": {
                                  "type": "array",
                                  "description": "Confidence level for each search query fired in the interaction. One entry per search query. Empty array if no search queries.",
                                  "items": {
                                    "type": "string",
                                    "enum": [
                                      "high",
                                      "medium",
                                      "low"
                                    ]
                                  }
                                },
                                "user_message": {
                                  "type": "object",
                                  "nullable": true,
                                  "description": "User message for the interaction, or null.",
                                  "properties": {
                                    "message_order": {
                                      "type": "integer",
                                      "description": "Order of the message within the conversation."
                                    },
                                    "author_role": {
                                      "type": "string",
                                      "description": "Author of the message.",
                                      "enum": [
                                        "User",
                                        "Agent"
                                      ]
                                    },
                                    "message_content": {
                                      "type": "string",
                                      "description": "Message content."
                                    },
                                    "created_at": {
                                      "type": "string",
                                      "format": "date-time",
                                      "nullable": true,
                                      "description": "ISO 8601 timestamp of the individual message."
                                    },
                                    "is_helpful": {
                                      "type": "boolean",
                                      "nullable": true,
                                      "description": "Visitor feedback: true if helpful, false if not helpful, null if no feedback was given."
                                    },
                                    "feedback": {
                                      "type": "object",
                                      "nullable": true,
                                      "description": "Detailed feedback with category and comment, or null if no feedback was given.",
                                      "properties": {
                                        "category": {
                                          "type": "string",
                                          "description": "Feedback category."
                                        },
                                        "comment": {
                                          "type": "string",
                                          "description": "Feedback comment."
                                        }
                                      }
                                    },
                                    "documents": {
                                      "type": "array",
                                      "description": "Referenced Trust Center documents.",
                                      "items": {
                                        "type": "object",
                                        "properties": {
                                          "id": {
                                            "type": "string",
                                            "format": "uuid",
                                            "description": "Document identifier."
                                          },
                                          "name": {
                                            "type": "string",
                                            "description": "Document name."
                                          }
                                        }
                                      }
                                    }
                                  }
                                },
                                "agent_responses": {
                                  "type": "array",
                                  "description": "Agent response messages for the interaction.",
                                  "items": {
                                    "type": "object",
                                    "properties": {
                                      "message_order": {
                                        "type": "integer",
                                        "description": "Order of the message within the conversation."
                                      },
                                      "author_role": {
                                        "type": "string",
                                        "description": "Author of the message.",
                                        "enum": [
                                          "User",
                                          "Agent"
                                        ]
                                      },
                                      "message_content": {
                                        "type": "string",
                                        "description": "Message content."
                                      },
                                      "created_at": {
                                        "type": "string",
                                        "format": "date-time",
                                        "nullable": true,
                                        "description": "ISO 8601 timestamp of the individual message."
                                      },
                                      "is_helpful": {
                                        "type": "boolean",
                                        "nullable": true,
                                        "description": "Visitor feedback: true if helpful, false if not helpful, null if no feedback was given."
                                      },
                                      "feedback": {
                                        "type": "object",
                                        "nullable": true,
                                        "description": "Detailed feedback with category and comment, or null if no feedback was given.",
                                        "properties": {
                                          "category": {
                                            "type": "string",
                                            "description": "Feedback category."
                                          },
                                          "comment": {
                                            "type": "string",
                                            "description": "Feedback comment."
                                          }
                                        }
                                      },
                                      "documents": {
                                        "type": "array",
                                        "description": "Referenced Trust Center documents.",
                                        "items": {
                                          "type": "object",
                                          "properties": {
                                            "id": {
                                              "type": "string",
                                              "format": "uuid",
                                              "description": "Document identifier."
                                            },
                                            "name": {
                                              "type": "string",
                                              "description": "Document name."
                                            }
                                          }
                                        }
                                      }
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "page": {
                      "type": "integer",
                      "description": "Current page number."
                    },
                    "per_page": {
                      "type": "integer",
                      "description": "Number of results per page."
                    },
                    "total_pages": {
                      "type": "integer",
                      "description": "Total number of pages."
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```