---
title: "Get the caller's own organization settings (id, display name and owner). Guarantees the organization row exists, creating it unpersonalized on first call, so its id can be used to address the organization's team-member endpoints. The name is the personalized one, otherwise the owner's billing company, otherwise null. Only a REGULAR_USER owner session may call this, and it requires a plan eligible for an organization."
method: GET
path: "/v2/settings/organizations"
tags: ["Organization Api Service"]
---

# Get the caller's own organization settings (id, display name and owner). Guarantees the organization row exists, creating it unpersonalized on first call, so its id can be used to address the organization's team-member endpoints. The name is the personalized one, otherwise the owner's billing company, otherwise null. Only a REGULAR_USER owner session may call this, and it requires a plan eligible for an organization.

`GET /v2/settings/organizations`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/settings/organizations`
- Auth: none declared

## Response `200`

Organization id, name and owner resolved.

- JsonOkResponseOrganizationDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` OrganizationDto: An account's organization settings.
    - `id` integer: Id of the organization. Always present -- the row is created on first access if the owner never personalized it. Use it to address /v2/organizations/{organizationId} endpoints (e.g. team members).
    - `name` string, nullable: Display name of the organization: the personalized name if the owner set one, otherwise the owner's billing company. Null when there is neither: the front shows its own default.
    - `owner` OrganizationOwnerDto: The owner of an organization.
      - `name` string: First name and last name of the owner, or their email when they have no first name.
      - `profilePicture` string, nullable: URL of the owner's profile picture. Null when they have none, and the front shows their initials instead.

## Other responses

- `403`: Caller is not a regular-user owner session, or its plan does not qualify for an organization.

---

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