Skip to main content
GET
/
api
/
v1
/
ontologies
/
{ontology_id}
curl https://api.intellibase.dev/api/v1/ontologies/ont-abc123 \
  -H "Authorization: Bearer ib-your-api-key"
{
  "id": "ont-abc123",
  "name": "Software Engineering",
  "created_at": "2024-01-15T10:30:00Z",
  "schema": {
    "ontology": {
      "hierarchy": [
        {
          "level": 0,
          "node_types": {
            "Developer": {
              "properties": ["name", "role", "team"],
              "description": "Software developer"
            },
            "Feature": {
              "properties": ["name", "status", "deadline"],
              "description": "Software feature"
            }
          }
        },
        {
          "level": 1,
          "node_types": {
            "Team": {
              "aggregates": ["Developer"],
              "properties": ["name", "focus"],
              "description": "Engineering team"
            }
          }
        }
      ],
      "edge_types": [
        {
          "name": "WORKS_ON",
          "source_types": ["Developer"],
          "target_types": ["Feature"],
          "properties": ["role"],
          "temporal": true,
          "description": "Developer works on feature"
        }
      ]
    }
  }
}

Endpoint

GET https://api.intellibase.dev/api/v1/ontologies/{ontology_id}

Path Parameters

ontology_id
string
required
The unique identifier of the ontology

Authentication

Requires a valid API key.

Response

id
string
Unique identifier for the ontology
name
string
Ontology name
created_at
string
When the ontology was created
schema
object
Complete ontology schema including hierarchy and edge types
curl https://api.intellibase.dev/api/v1/ontologies/ont-abc123 \
  -H "Authorization: Bearer ib-your-api-key"
{
  "id": "ont-abc123",
  "name": "Software Engineering",
  "created_at": "2024-01-15T10:30:00Z",
  "schema": {
    "ontology": {
      "hierarchy": [
        {
          "level": 0,
          "node_types": {
            "Developer": {
              "properties": ["name", "role", "team"],
              "description": "Software developer"
            },
            "Feature": {
              "properties": ["name", "status", "deadline"],
              "description": "Software feature"
            }
          }
        },
        {
          "level": 1,
          "node_types": {
            "Team": {
              "aggregates": ["Developer"],
              "properties": ["name", "focus"],
              "description": "Engineering team"
            }
          }
        }
      ],
      "edge_types": [
        {
          "name": "WORKS_ON",
          "source_types": ["Developer"],
          "target_types": ["Feature"],
          "properties": ["role"],
          "temporal": true,
          "description": "Developer works on feature"
        }
      ]
    }
  }
}
Use this endpoint to retrieve the complete ontology schema before creating a project or to inspect the structure.