---
title: "Get version create request status (getVersionCreateRequestStatus)"
method: GET
path: "/api/entities/vc/version/{requestId}/status"
tags: ["entities-version-control-controller"]
---

# Get version create request status (getVersionCreateRequestStatus)

`GET /api/entities/vc/version/{requestId}/status`

Returns the status of previously made version create request. 

This status contains following properties:
- `done` - whether request processing is finished;
- `version` - created version info: timestamp, version id (commit hash), commit name and commit author;
- `added` - count of items that were created in the remote repo;
- `modified` - modified items count;
- `removed` - removed items count;
- `error` - error message, if an error occurred while handling the request.

An example of successful status:
```json
{
  "done": true,
  "added": 10,
  "modified": 2,
  "removed": 5,
  "version": {
    "timestamp": 1655198528000,
    "id":"8a834dd389ed80e0759ba8ee338b3f1fd160a114",
    "name": "My devices v2.0",
    "author": "John Doe"
  },
  "error": null
}
```

Available for users with 'TENANT_ADMIN' authority.

## Path parameters

- `requestId` string, uuid, required

## Response `200`

OK

- VersionCreationResult
  - `version` EntityVersion
    - `timestamp` integer
    - `id` string
    - `name` string
    - `author` string
  - `added` integer
  - `modified` integer
  - `removed` integer
  - `error` string
  - `done` boolean

---

[API](https://skmtc.net/thingsboard/apis/thingsboard-rest-api.md) · [All operations](https://skmtc.net/thingsboard/apis/thingsboard-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thingsboard/thingsboard-rest-api/revisions/40169ccdec5c/schema)
