# Get repos

URL: https://docs.hanzo.ai/docs/openapi/git/get-git-repos-by-name

> Returns one repo with its live ref state: every branch name and the resolved HEAD commit.

`GET /v1/git/repos/{name}`

> [Git →](https://docs.hanzo.ai/docs/openapi/git) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides)

|               |                                            |
| ------------- | ------------------------------------------ |
| **Address**   | `https://api.hanzo.ai/v1/git/repos/{name}` |
| **Method**    | `GET`                                      |
| **Operation** | `get_git_repos_by_name`                    |
| **Auth**      | `Authorization: Bearer $HANZO_API_KEY`     |

Returns one repo with its live ref state: every branch name and the
resolved HEAD commit. Both are read from the object store on each call, so an
empty repo reports no branches and an empty head rather than failing. A repo
outside the caller's scope is not found.

## Request

1 field.

| Field  | In   | Type   | Required | Description                                                        |
| ------ | ---- | ------ | -------- | ------------------------------------------------------------------ |
| `name` | path | string | yes      | Name is the repo's org-unique handle, from the :name path segment. |

## Response

| Status    | Body            | Meaning |
| --------- | --------------- | ------- |
| `200`     | git.repoView    | ok      |
| `default` | problem-details | refused |

`200` body — 14 fields.

| Field           | In   | Type            | Always | Description                                                                                            |
| --------------- | ---- | --------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| `branches`      | body | string\[]       | —      | Branches are the repo's branch names.                                                                  |
| `cloneUrl`      | body | string          | —      | CloneURL is the HTTPS smart-HTTP remote `git clone` takes.                                             |
| `createdAt`     | body | string          | —      | CreatedAt is RFC 3339 UTC.                                                                             |
| `defaultBranch` | body | string          | —      | DefaultBranch is where HEAD points on a fresh repo ("main").                                           |
| `description`   | body | string          | —      | Description is the caller-supplied blurb (max 4KiB).                                                   |
| `head`          | body | string          | —      | Head is the resolved HEAD commit, empty on an empty repo.                                              |
| `id`            | body | string          | —      | ID is the repo's stable, prefixed identifier ("repo\_" + 128 random bits).                             |
| `name`          | body | string          | —      | Name is the org-unique handle, and the last path segment of both URLs below.                           |
| `org`           | body | string          | —      | Org owns the repo — the gateway-minted X-Org-Id, and the isolation key.                                |
| `project`       | body | string          | —      | Project is the optional sub-scope the repo lives in; absent for the org's default scope.               |
| `public`        | body | boolean         | —      | Public grants ANONYMOUS read (fetch) only; push and the whole control plane stay org-authed.           |
| `sizeBytes`     | body | integer (int64) | —      | SizeBytes is the repo's measured on-disk size, re-measured on create, after each push, and after a gc. |
| `sshUrl`        | body | string          | —      | SSHURL is the scp-style SSH remote (git\@host:org/repo.git).                                           |
| `updatedAt`     | body | string          | —      | UpdatedAt is RFC 3339 UTC, empty until the first write.                                                |

Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors).

## Examples

**CLI**

```bash
hanzo git repos get <name>
```

**SDK**

**.ts**

```ts
import { Configuration, GitApi } from 'hanzoai';

const api = new GitApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getGitReposByName({ name: 'name' });
```

**.py**

```python
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import GitApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = GitApi(client).get_git_repos_by_name(name='name')
```

**.go**

```go
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.GitAPI.GetGitReposByName(context.Background()).Execute()
if err != nil {
	return err
}
```

**.rs**

```rust
use hanzo_client::apis::{configuration::Configuration, git_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = git_api::get_git_repos_by_name(&cfg, Default::default()).await?;
```

**.java**

```java
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.GitApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new GitApi(client).getGitReposByName();
```

**HTTP**

```bash
curl https://api.hanzo.ai/v1/git/repos/<name> \
  -H "Authorization: Bearer $HANZO_API_KEY"
```

**MCP**

MCP reaches **git** through the `git` tool, which names its 38 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them:

```bash
curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_git_keys"
         }
       }
     }'
```

---

[Git API](https://docs.hanzo.ai/docs/openapi/git) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)