---
title: "By handle"
method: GET
path: "/orgs/connections/by_handle/v1/{handle}"
tags: ["/orgs", "/connections"]
---

# By handle

`GET /orgs/connections/by_handle/v1/{handle}`

Gets the connection between caller's org and the org with the specified handle. | () -> (ShipperCoordinatorConnection1 | CoordinatorExecutorConnection1 | None)

## Path parameters

- `handle` string, required — Must be a string starting with `@`. May only contain a-z, A-Z, 0-9, _, -. May not be longer than 30 characters.

## Response `200`

Successful Response

- union
  - ShipperCoordinatorConnection1
    - `schema_version` 1, required
    - `shipper_org_id` string, nullable — Must be a string starting with `org_`
    - `off_chrt_shipper_org_data_id` string, nullable
    - `coordinator_org_id` string, required — Must be a string starting with `org_`
    - `connected` boolean
    - `shipper_customer_id_for_coordinator_stripe_connect_account` string, nullable
    - `coordinator_default_department_id` string, nullable
    - `_id` string, required
  - CoordinatorExecutorConnection1
    - `schema_version` 1, required
    - `coordinator_org_id` string, required — Must be a string starting with `org_`
    - `executor_org_id` string, nullable — Must be a string starting with `org_`
    - `off_chrt_executor_org_data_id` string, nullable
    - `connected` boolean
    - `auto_assign_enabled` boolean, nullable
    - `coordinator_customer_id_for_executor_stripe_connect_account` string, nullable
    - `_id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)