Hanzo AIDocs
Sign inAPI key

Get center

Answers an org's public trust centre: its name, the text a party must accept to ask for a document, and every item it publishes.

GET /v1/dataroom/trust/center/{slug}

Dataroom → · All API references → · Get started →

Addresshttps://api.hanzo.ai/v1/dataroom/trust/center/{slug}
MethodGET
Operationget_dataroom_trust_center_by_slug
AuthAuthorization: Bearer $HANZO_API_KEY

Answers an org's public trust centre: its name, the text a party must accept to ask for a document, and every item it publishes.

An item is either available NOW — the things the org states itself, its policies, its filled questionnaires, its subprocessor list, its knowledge base — or available ON REQUEST, which is everything an independent auditor put their name to. Both are listed by name and kind, so a reader can see WHAT exists before asking for it; only the second withholds the content.

No principal is involved and none is accepted: the org is resolved from the address, which answers only for a centre its owner has published. An address nobody publishes at is not found, the same answer an unpublished one gets.

Request

1 field.

FieldInTypeRequiredDescription
slugpathstringyesSlug is the centre's public address.

Response

StatusBodyMeaning
200dataroom.trustPageok
defaultproblem-detailsrefused

200 body — 13 fields.

FieldInTypeAlwaysDescription
itemsbodydataroom.trustItem[]—Items is everything the centre publishes: what can be read now, and what exists and is released on request.
items[].availablebodystring—Available is "now" when the item can be read immediately, or "on request" when it is released only to a party who asks and is answered.
items[].bodybodystring—Body is the item's content, for the kinds that are text rather than a file — an article, a subprocessor entry, a note.
items[].frameworkbodystring—Framework is the standard the item speaks to, when it speaks to one.
items[].idbodystring—ID addresses the item — for reading it if it is available now, or for naming it in a request if it is not.
items[].kindbodystring—Kind is what the item is: report, letter, policy, questionnaire, subprocessor, article or update.
items[].namebodystring—Name is the item's title.
items[].signedbodystring—Signed is "self" when the org states it itself and "auditor" when an independent auditor put their name to it.
items[].summarybodystring—Summary is a line about the item.
items[].updatedAtbodyinteger (int64)—UpdatedAt is when the item last changed, in unix milliseconds.
namebodystring—Name is the org's display name for its centre.
ndabodystring—Nda is the text a party must accept to ask for the gated items, verbatim.
slugbodystring—Slug is the centre's public address.

Failure carries the platform error shape — see Errors.

Examples

hanzo dataroom trust center get <slug>
import { Configuration, DataroomApi } from 'hanzoai';

const api = new DataroomApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getDataroomTrustCenterBySlug({ slug: 'slug' });
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import DataroomApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = DataroomApi(client).get_dataroom_trust_center_by_slug(slug='slug')
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.DataroomAPI.GetDataroomTrustCenterBySlug(context.Background()).Execute()
if err != nil {
	return err
}
use hanzo_client::apis::{configuration::Configuration, dataroom_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = dataroom_api::get_dataroom_trust_center_by_slug(&cfg, Default::default()).await?;
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.DataroomApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new DataroomApi(client).getDataroomTrustCenterBySlug();
curl https://api.hanzo.ai/v1/dataroom/trust/center/<slug> \
  -H "Authorization: Bearer $HANZO_API_KEY"

MCP reaches dataroom through the dataroom tool, which names its 19 operations with its own verbs — this one among them, under a name only MCP declares. describe explains any of them:

curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "get_dataroom_analytic_dataroom"
         }
       }
     }'

Dataroom API · All Hanzo APIs · Interactive reference

Was this page useful?
PreviousGet fileNextList trust