---
title: "Get Revisions"
url: "https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading"
version: "6.2"
language: "java"
---

# Get Revisions

> Client language: Java. Also available for [C#](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.md), [Python](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.python.md), [PHP](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.php.md), [Node.js](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/loading.nodejs.md).
>
> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

There are a few methods that allow you to retrieve revisions from a database:

- **session.advanced().revisions().getFor**
  - can be used to return all previous revisions for a specified document
- **session.advanced().revisions().getMetadataFor**
  - can be used to return metadata of all previous revisions for a specified document
- **session.advanced().revisions().get**
  - can be used to retrieve a revision(s) using a change vector(s)

## getFor

### Syntax

```java
<T> List<T> getFor(Class<T> clazz, String id);

<T> List<T> getFor(Class<T> clazz, String id, int start);

<T> List<T> getFor(Class<T> clazz, String id, int start, int pageSize);
```

| Parameters | | |
| - | - | - |
| **id** | String | document ID for which the revisions will be returned for |
| **start** | int | used for paging |
| **pageSize** | int | used for paging |

### Example

```java
List<Order> orderRevisions = session
  .advanced()
  .revisions()
  .getFor(Order.class, "orders/1-A", 0, 10);
```

## getMetadataFor

### Syntax

```java
List<MetadataAsDictionary> getMetadataFor(String id);

List<MetadataAsDictionary> getMetadataFor(String id, int start);

List<MetadataAsDictionary> getMetadataFor(String id, int start, int pageSize);
```

| Parameters | | |
| - | - | - |
| **id** | String | document ID for which the revisions will be returned for |
| **start** | int | used for paging |
| **pageSize** | int | used for paging |

### Example

```java
List<MetadataAsDictionary> orderRevisionsMetadata = session
  .advanced()
  .revisions()
  .getMetadataFor("orders/1-A", 0, 10);
```

## get

### Syntax

```java
<T> T get(Class<T> clazz, String changeVector);

<T> Map<String, T> get(Class<T> clazz, String[] changeVectors);
```

| Parameters | | |
| - | - | - |
| **changeVector** or **changeVectors** | `String` or `String[]` | one or many revision change vectors |

### Example

```java
Order orderRevision = session
  .advanced()
  .revisions()
  .get(Order.class, orderRevisionChangeVector);
```

## See also

- [Document Revisions Overview](https://docs.ravendb.net/6.2/document-extensions/revisions/overview.md)
- [Revert Revisions](https://docs.ravendb.net/6.2/document-extensions/revisions/revert-documents-to-revisions/revert-documents-to-specific-time.md)
- [Revisions and Other Features](https://docs.ravendb.net/6.2/document-extensions/revisions/revisions-and-other-features.java.md)
- [Revisions: API Overview](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/overview.java.md)
- [Operations: Configuring Revisions](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/operations/configure-revisions.java.md)
- [Session: Including Revisions](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/including.md)
- [Session: Counting Revisions](https://docs.ravendb.net/6.2/document-extensions/revisions/client-api/session/counting.md)
- [Settings: Document Revisions](https://docs.ravendb.net/6.2/studio/database/settings/document-revisions.md)
- [Document Extensions: Revisions](https://docs.ravendb.net/6.2/studio/database/settings/document-revisions.md)
