---
updatedAt: 2026-06-18T12:14:42.000Z
agentTools:
  projectIndex: https://developer.liveswitch.com/llms.txt
---

# Gets your currently logged in organization settings.

**Required scope:** `organizations`

Selects the organization settings for the organization you are currently logged into.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "LiveSwitch Public API",
    "version": "v1"
  },
  "servers": [
    {
      "url": "https://public-api.production.liveswitch.com/",
      "description": "Public API"
    }
  ],
  "paths": {
    "/v1/organizations/settings": {
      "get": {
        "tags": [
          "Organizations"
        ],
        "summary": "Gets your currently logged in organization settings.",
        "description": "**Required scope:** `organizations`",
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrganizationSettingsDto"
                }
              }
            }
          }
        },
        "security": [
          {
            "oauth2": [
              "organizations"
            ]
          }
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "OrganizationSettingsDto": {
        "type": "object",
        "properties": {
          "defaultCountryCode": {
            "type": "string",
            "nullable": true
          },
          "autoStartRecordings": {
            "type": "boolean"
          },
          "isTestAccount": {
            "type": "boolean"
          },
          "isSmsEnabled": {
            "type": "boolean"
          }
        },
        "additionalProperties": false
      }
    },
    "securitySchemes": {
      "oauth2": {
        "type": "oauth2",
        "description": "OAuth2 authentication using Auth0 Implicit flow",
        "flows": {
          "implicit": {
            "authorizationUrl": "https://id.staging.liveswitch.com/authorize",
            "scopes": {
              "openid": "OpenID Connect scope",
              "profile": "Access to user profile",
              "email": "Access to user email",
              "me": "Access to user information",
              "contacts": "Read access to contacts",
              "contacts.write": "Write access to contacts",
              "conversations": "Read access to conversations",
              "conversations.write": "Write access to conversations",
              "organizations": "Read access to organizations",
              "webhooks": "Read access to webhooks",
              "webhooks.write": "Write access to webhooks",
              "applications": "Read access to applications",
              "applications.write": "Write access to applications",
              "forms": "Read access to forms",
              "projects": "Read access to projects",
              "projects.write": "Write access to projects",
              "recordings": "Read access to recordings",
              "documents": "Read access to documents",
              "accounts": "Read access to accounts",
              "guided-instructions": "Read access to guided instructions",
              "sparks": "Read access to Spark runs",
              "sparks.write": "Write access to Spark runs",
              "spark-templates": "Read access to installed Spark templates for the organization",
              "scribe-templates": "Read access to installed Scribe templates (legacy)"
            }
          }
        }
      },
      "bearer": {
        "type": "http",
        "description": "<p>Please enter a valid token. This shoud NOT include the Bearer: prefix, but just the token itself.</p>\n            <br/>\n             <p>To generate a token from the Swagger UI:</p>\n             <p>\n               1. Select the 'v1/tokens' endpoint in the Swagger UI<br/>\n               2. Set the 'redirect' setting to false<br/>\n               3. Fill in the values according to your application configuration<br/>\n               4. Click 'Execute'<br/>\n            </p>\n            <br/>\n            <p>\n            The response from this request will include the URL you need to generate a token. Copy/paste it into a new window and follow the instructions.\n            </p>",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ]
}
```

# Sibling pages

* [Updates the SMS enabled setting for your currently logged in organization.](https://developer.liveswitch.com/reference/patch_v1-organizations-sms-enabled.md)