Models

For endpoints that require a model ID (model_id), you can retrieve it in our app directly from the model URL.

Our model URLs follow the format below:

https://app.kondado.com.br/models/:model_id

Get Model Status

Description

Returns the status of a given model using its model_id.

Method

GET

Endpoint

/models/:model_id/status

URL Parameters

None

Example Response

{
    "success": true,
    "data": {
        "162": {
            "status": "active",
            "is_running": false,
            "is_active": true,
            "kubo_status_type": "operational"
        }
    }
}

Response Description

The response will be a JSON object where the model ID is used as the key of a nested JSON object containing the fields described below.

status

Status description. Possible values are:

  • running: The model is currently running.
  • scheduled: The model is queued for execution.
  • active: The model is not running and not queued, but is active.
  • not_active: The model is not running, not queued, and is disabled.

raw_msg

If the model encounters any issues, this field will contain the error description (for example, if we are unable to connect to your source or destination).

kubo_status_type

Describes the current state of the model. Possible values are:

  • not_published: The model is in draft mode.
  • rebuilding: The model was recently changed and has not yet been executed with its new configuration.
  • operational: The model is stable — it is not in draft mode and all changes have already been executed.

is_running

Boolean indicating whether the Pipeline is currently running (status = running).

is_active

Boolean indicating whether the Pipeline is active (status = active) or disabled (status = not_active).

Check a Model's Execution and Operational Status

Use the Kondado API to retrieve the current status and health of any model by its model_id.

1
Locate the model_id

Open the model in the Kondado app and copy the ID from the URL, which follows the format https://app.kondado.com.br/models/:model_id. You can also explore the Kondado platform to manage your pipelines.

2
Call the status endpoint

Make a GET request to /models/:model_id/status. No URL parameters are required.

3
Interpret the status field

Check the status value: running means execution is in progress; scheduled means queued; active means idle but enabled; not_active means disabled.

4
Review kubo_status_type

Verify kubo_status_type to confirm operational health: not_published (draft), rebuilding (pending first run with new config), or operational (stable and executed).

5
Check error details if needed

If issues exist, read raw_msg for the error description—commonly connection problems to your source or destination. Learn more about data integration to troubleshoot connectivity.

6
Validate booleans

Use is_running and is_active as quick boolean checks to confirm whether the pipeline is currently executing or enabled.

Frequently asked questions

Where do I find the model_id for a pipeline?
You can retrieve the model_id directly from the model URL in the Kondado app. The URL follows the format https://app.kondado.com.br/models/:model_id, where the ID appears after /models/.
What does the status 'active' mean versus 'running'?
'Active' means the model is enabled but not currently executing or queued. 'Running' means the model is actively processing data at that moment. 'Scheduled' indicates it is queued for execution, while 'not_active' means the model is disabled.
What should I do if raw_msg contains an error?
The raw_msg field describes connection or configuration issues, such as failure to reach your source or destination. Review your credentials and network settings, or explore data integration best practices to resolve connectivity problems.
How do I know if my model is stable and production-ready?
Check kubo_status_type: 'operational' means the model is stable, not in draft mode, and all changes have been executed. 'not_published' means draft mode, and 'rebuilding' means recent changes haven't been executed yet.
Can I check model status without using the API?
This article covers the API endpoint for programmatic status checks. For visual monitoring and management, you can use the Kondado platform interface directly.

Written by·Published 2026-01-12·Updated 2026-04-25