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

# Get Branches

`GET /v1/branches/{connector_id}`

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.net/tryardent/apis/fastapi.md) · [All operations](https://skmtc.net/tryardent/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tryardent/fastapi/revisions/885763e37dfb/schema)