Skip to main content

Organization Tools

Tools for exploring your organization hierarchy, metrics, and group structure.

get_organization_metrics

Get a summary of what data exists for an organization — counts of facilities, vehicles, employees, purchases, business travels, logistics, and more. Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the organization. Uses DCYCLE_ORG_ID default if not set.
Example queries:
"How many facilities and vehicles do we have?"
"Give me an overview of our organization data"
"What data is available for my organization?"
Example response:
{
  "limits": { "facilities": 50, "vehicles": 100, "employees": 100 },
  "facilities": 25,
  "vehicles": 69,
  "employees": 99,
  "purchases": 59197,
  "business_travels": 2349,
  "logistic_requests": 154522,
  "sold_products": 8
}

get_organization_tree

Get the parent-child hierarchy tree. Useful for corporate groups with subsidiaries. Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the root organization
include_facilitiesbooleanNoInclude facilities in each org node (default: false)
Example queries:
"Show me the organization structure"
"Which subsidiaries does my company have?"
"Show the org tree with facilities included"
Example response:
{
  "id": "cefc7985-...",
  "name": "Parent Corp",
  "children": [
    {
      "name": "Spain Office",
      "children": []
    },
    {
      "name": "Italy Branch",
      "children": [
        { "name": "Milan Factory", "children": [] }
      ]
    }
  ]
}

get_organization_canvas

Get a canvas view of all organizations in the group with their connections, sectors, countries, and VAT numbers. Parameters:
ParameterTypeRequiredDescription
organization_idstringNoUUID of the organization
Example queries:
"Show me all companies in the group with their countries"
"Which organizations are connected to each other?"
Example response:
[
  {
    "org_id": "cefc7985-...",
    "org_name": "Parent Corp",
    "country": "ES",
    "sector": "transport",
    "inputs": null,
    "outputs": ["child-uuid-1", "child-uuid-2"]
  },
  {
    "org_id": "child-uuid-1",
    "org_name": "Spain Office",
    "country": "ES",
    "sector": "logistics",
    "inputs": ["cefc7985-..."],
    "outputs": null
  }
]