From 718b3b8a7e0b90d6143684be9dfc18e6cff9e4ad Mon Sep 17 00:00:00 2001
From: Daniel Moerner <daniel@clerk.dev>
Date: Mon, 20 Apr 2026 21:21:50 -0400
Subject: [PATCH] feat(backend): GET organization settings

We recently added this BAPI endpoint because agents expect it to exist;
they want to GET organization settings before doing a PATCH. Add support
to the Javascript SDK as well.

I didn't bother with unit tests here because it would just be a thin
mock.
---
 .changeset/tiny-bobcats-train.md                  | 5 +++++
 packages/backend/src/api/endpoints/InstanceApi.ts | 7 +++++++
 2 files changed, 12 insertions(+)
 create mode 100644 .changeset/tiny-bobcats-train.md

diff --git a/.changeset/tiny-bobcats-train.md b/.changeset/tiny-bobcats-train.md
new file mode 100644
index 00000000000..e76e96a6974
--- /dev/null
+++ b/.changeset/tiny-bobcats-train.md
@@ -0,0 +1,5 @@
+---
+'@clerk/backend': minor
+---
+
+Add backend query to GET organization settings for an instance.
diff --git a/packages/backend/src/api/endpoints/InstanceApi.ts b/packages/backend/src/api/endpoints/InstanceApi.ts
index d2fed3f7880..b7d29b32ae8 100644
--- a/packages/backend/src/api/endpoints/InstanceApi.ts
+++ b/packages/backend/src/api/endpoints/InstanceApi.ts
@@ -91,6 +91,13 @@ export class InstanceAPI extends AbstractAPI {
     });
   }
 
+  public async getOrganizationSettings() {
+    return this.request<OrganizationSettings>({
+      method: 'GET',
+      path: joinPaths(basePath, 'organization_settings'),
+    });
+  }
+
   public async updateOrganizationSettings(params: UpdateOrganizationSettingsParams) {
     return this.request<OrganizationSettings>({
       method: 'PATCH',