---
title: "Get Branches"
method: GET
path: "/v1/branches/{connector_id}"
tags: ["v1-branching"]
---

# Get Branches

`GET /v1/branches/{connector_id}`

## Request

- Base URL: `https://api.tryardent.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tryardent.com/v1/branches/{connector_id}`
- Auth: none declared

Get branch metadata for a connector.

Authorization: User must be authenticated and the connector must belong to
an org the user has access to. RLS on branches checks
current_user_accessible_connectors.

## Path parameters

- `connector_id` string, required

## Response `200`

Up to 100 branch rows for the connector. Rows may carry additional columns beyond the documented core.

- BranchRow[]
  - `id` string, required: Branch ID.
  - `name` string, required: Branch name, as given at create.
  - `connector_id` string, required: Connector this branch was created from.
  - `service_type` string, required: Branched service. `postgres` for Postgres branches.
  - `status` string, required: Current branch status.
  - `created_at` string, required: When the branch was created.
  - `last_branch_activity` string, nullable: Most recent activity on the branch. Null when none has been recorded.
  - `read_ready_at` string, nullable: When the branch became ready for reads. Null until then.
  - `write_ready_at` string, nullable: When the branch became ready for writes. Null until then.
  - `masked_ready_at` string, nullable: When masked data became ready. Null until then.
  - `branch_url` string, nullable: Direct connection URL for the branch; sensitive — use exactly as returned.
  - `pooled_branch_url` string, nullable: Pooled connection URL. Null when the provider has no pooled endpoint.
  - `pooled_branch_prisma_url` string, nullable: Prisma-formatted pooled URL; null when the provider has no pooled endpoint.

## Other responses

- `404`: Connector not found (or not visible to the caller).
- `422`: Validation Error

---

[API](https://skmtc.dev/tryardent/apis/tryardent-api.md) - [All operations](https://skmtc.dev/tryardent/apis/tryardent-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tryardent/apis/tryardent-api/revisions/a0512915b997?raw)