Get Semantic Models List

This documentation is for Kyvos 2026.6.x. To view documentation for other Kyvos versions, click here.

This documentation is for Kyvos 2026.6.x. To view documentation for other Kyvos versions, click here.

Overview

This API retrieves a list of Semantic Models and folders containing Semantic Models from the root directory.

Method: GET

Request URL: {kyvos-url}/rest/v2/semantic-models

Authorization

API Key: `sessionid`

This method authenticates requests using a session ID which acts like an API key.

BasicAuth: HTTP Authorization Scheme

This method authenticates requests using a username and password sent in the HTTP Authorization header.

Headers

Header Name	Type	Description	Possible Values

Header Name

Type

Description

Possible Values

sessionid

String

The session ID is the token received from the login API.

Note: Session ID is required for token-based authentication.

–

Query Parameters

Parameter Name	Type	Description	Possible Values

Parameter Name	Type	Description	Possible Values
fetchProcessedStatus	Boolean	Specifies whether the processed status of Semantic Models should be included in the response.	`true` / `false` Default: `false`
queryableModelsOnly	Boolean	Retrieves only those Semantic Models on which queries can be executed.	`true` / `false` Default: `false`
show	String	Determines the type of objects returned in the response. The response can contain folders, Semantic Models, or both.	all – Returns folders and Semantic Models from the root directory. list – Returns only Semantic Models from the root directory. folders – Returns only folders. Default: `all`
owner	String	Filters Semantic Models by owner (the user who created the entity).	–
tags	String	Filters Semantic Models by tags. This filter applies only to Semantic Models containing at least one tag.	–
searchText	String	Filters Semantic Models by name. All Semantic Models whose names contain the specified text are included in the response, irrespective of case.	–
modifiedAfter	String	Filters Semantic Models modified after the specified Unix timestamp.	–
modifiedBefore	String	Filters Semantic Models modified before the specified Unix timestamp.	–
count	Number	Specifies the maximum number of records returned in the response. This parameter is applicable only when show=list or show=folders. Note: The `count` parameter is applied only when its value is positive. If the value is negative, all available records are returned. Default: `500`.	–
lastEntityName	String	Returns only the entities occurring after the specified entity name.	–
lastEntityId	String	Returns only the entities occurring after the specified entity ID.	–

Responses

200 Success

{
    "folders":[
        {
            "name":"Sales_Analysis",
            "id":"folder_17600903510657127081096133841755",
            "owner":{
                "name":"admin",
                "id":"392958299"
            },
            "lastModified":"04/20/2026 12:30:09 IST",
            "accessRights":1
        },
        {
            "name":"Product",
            "id":"folder_17011860932783127099097178543653",
            "owner":{
                "name":"testadmin",
                "id":"392958299"
            },
            "lastModified":"04/20/2026 12:30:09 IST",
            "accessRights":1
        }
    ],
    "semanticModels":[
        {
            "owner":"admin",
            "name":"Accounts",
            "id":"17754751954757127014056190785997",
            "lastModified":"04/20/2026 12:30:09 IST",
            "accessRights":1,
            "ownerId":"392958299",
            "lastModifiedTimestamp":1776668409275,
            "allowRawDataQuery":false
        },
        {
            "owner":"admin",
            "name":"OrderDate",
            "id":"17713109961456127077083129389854",
            "lastModified":"04/20/2026 12:30:09 IST",
            "accessRights":1,
            "ownerId":"392958299",
            "lastModifiedTimestamp":1776668409275,
            "allowRawDataQuery":false
        }
    ]
}

Status Code	Description

Status Code	Description
401	Authorization information is missing or invalid.
404	No matching record found.
500	Internal Server Error