---
title: "Get pull status for a project revision"
method: GET
path: "/v1/integration/advanced-dsl/projects/{projectId}/pull-status"
tags: ["Advanced DSL Project Management"]
---

# Get pull status for a project revision

`GET /v1/integration/advanced-dsl/projects/{projectId}/pull-status`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/advanced-dsl/projects/{projectId}/pull-status`
- Auth: HTTP bearer

Retrieves pull readiness information for a project revision.
Returns file count and total size for download estimation.
If `revisionNumber` is not provided, the latest revision is used.

**Features:**
- Optional revision selection via `revisionNumber`
- File count and total size estimation
- Latest-or-specific revision resolution
- Download feasibility check

**Use Cases:**
- Pre-pull size estimation for the latest revision
- Pre-pull size estimation for progress bars
- Bandwidth check before large downloads
- Preflight checks before full `/pull` download

**Scenarios:**
- No `revisionNumber` provided → latest revision is evaluated
- `revisionNumber` provided → the requested revision is evaluated
- Ready state with known file count and total size
- Lightweight pre-check before full `/pull` operation

**Required Permissions:** `replication-pipeline::view`

## Path parameters

- `projectId` string, required

## Query parameters

- `revisionNumber` integer

## Response `200`

Pull status retrieved successfully

- PullStatusResponse: Pull readiness status for a specific project revision
  - `projectId` string: The project ID (catalog asset ID)
  - `revisionId` string: The revision ID being checked
  - `revisionNumber` integer: The revision number being checked
  - `fileCount` integer: Number of files in this revision
  - `totalSizeBytes` integer: Total size of all files in bytes
  - `status` 'ready' | 'unavailable': Pull readiness status

## Other responses

- `401`: Unauthorized — authentication required
- `403`: Forbidden — user lacks 'replication-pipeline::view' permission
- `404`: Project or revision not found
- `500`: Internal server error during pull status check

---

[API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)