---
title: "Get the status of a dbt sync"
method: GET
path: "/api/v1/deployments/{deploymentId}/dbt-sync/{syncJobId}"
tags: ["dbt Sync"]
---

# Get the status of a dbt sync

`GET /api/v1/deployments/{deploymentId}/dbt-sync/{syncJobId}`

## Path parameters

- `deploymentId` integer, required
- `syncJobId` string, required

## Response `200`

- DbtSyncStatusResponse
  - `error` string, nullable — Why the sync stopped. Present only when the status is FAILED.
  - `progress` DbtSyncProgress, required
    - `message` string, nullable — Human-readable description of what the sync is doing right now.
    - `percentComplete` integer, required — Rough completion percentage derived from the stage. Progress reporting only — do not gate on it; gate on the status reaching COMPLETED or FAILED.
    - `stage` string, required — The stage the sync is currently in, from the same set of values as the sync status.
  - `status` string, required — One of INITIALIZING, CREATING_SANDBOX, UPLOADING_PROJECT, INSTALLING_DEPENDENCIES, RUNNING_DBT_DEPS, COMPILING_DBT, PROCESSING_MANIFEST, WRITING_CUBE_FILES, FINALIZING, COMPLETED, FAILED. COMPLETED and FAILED are the only terminal values: poll until one of them, then read the result. Treat any unrecognized value as still running.
  - `syncJobId` string, required
  - `updatedAt` string, required — When this status was last updated, as an ISO 8601 timestamp.

---

[API](https://skmtc.net/cube-js/apis/cube-cloud-rest-api.md) · [All operations](https://skmtc.net/cube-js/apis/cube-cloud-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cube-js/cube-cloud-rest-api/revisions/29d481391a25/schema)