> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blobhub.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Resolve Revision

> Read one revision of a named blob, by id or by the reserved word default

Retrieve one revision, scoped to a specific blob. This is the route to follow a blob's default revision
without first reading the blob record for its pointer.

## **GET** `/blobs/:org_id/:blob_id/revisions/:ref`

Requires Read access to the blob.

### Path Parameters

| Parameter | Type   | Required | Description                                                                                            |
| :-------- | :----- | :------- | :----------------------------------------------------------------------------------------------------- |
| `org_id`  | string | Yes      | The unique ID of the organization.                                                                     |
| `blob_id` | string | Yes      | The unique ID or alias of the blob.                                                                    |
| `ref`     | string | Yes      | A revision id, or the literal `default` for whatever the blob's `default_revision_id` currently names. |

### Response

| Parameter  | Type   | Description                                                                          |
| :--------- | :----- | :----------------------------------------------------------------------------------- |
| `revision` | object | The revision, in the same shape as [List Revisions](/rest-api/blobs/list-revisions). |

`ref` is resolved against this `blob_id` specifically: a revision id belonging to another blob answers the
same `revision_not_found` as one that does not exist at all, so this route cannot be used to read a revision
through a blob the caller merely has access to.

### Errors

| Status | Error                | Cause                                                                                                                                                    |
| :----- | :------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 403    | `forbidden`          | The blob is absent or not visible to this key.                                                                                                           |
| 409    | `blob_not_ready`     | The blob is being created or deleted.                                                                                                                    |
| 404    | `revision_not_found` | `ref` is `default` and the blob has no `default_revision_id` yet, `ref` names an unknown revision, or it names a revision belonging to a different blob. |

### Example

<CodeGroup>
  ```bash Request theme={null}
  curl -X GET https://api.blobhub.io/v1/blobs/org_123/blob_789/revisions/default
  ```

  ```json Response theme={null}
  {
    "status": "success",
    "revision": {
      "id": "rev_002",
      "blob_id": "blob_789",
      "parent_id": "rev_001",
      "comment": "add the refund branch",
      "user_id": "usr_a1b2c3d4",
      "created_at": "2026-07-14T09:12:03Z",
      "updated_at": "2026-07-14T09:12:05Z",
      "status": "ready",
      "phase": "draft"
    }
  }
  ```
</CodeGroup>

## See also

* [Get Revision](/rest-api/revisions/get-revision) — the id-only equivalent, for when the blob is not at hand.
* [List Revisions](/rest-api/blobs/list-revisions) — every revision of the blob, paged.