---
title: "Get organization"
method: POST
path: "/public/v1/query/get_organization"
tags: ["Organizations"]
---

# Get organization

`POST /public/v1/query/get_organization`

Get details about an organization.

## Request body

- V1GetOrganizationRequest
  - `organizationId` string, required — Unique identifier for a given organization.

## Response `200`

A successful response.

- V1GetOrganizationResponse
  - `organizationData` V1OrganizationData, required
    - `organizationId` string
    - `name` string
    - `users` V1User[]
      - `userId` string, required — Unique identifier for a given User.
      - `userName` string, required — Human-readable name for a User.
      - `userEmail` string — The user's email address.
      - `userPhoneNumber` string — The user's phone number in E.164 format e.g. +13214567890
      - `authenticators` V1Authenticator[], required — A list of Authenticator parameters.
        - `transports` V1AuthenticatorTransport[], required — Types of transports that may be used by an Authenticator (e.g., USB, NFC, BLE).
        - `attestationType` string, required
        - `aaguid` string, required — Identifier indicating the type of the Security Key.
        - `credentialId` string, required — Unique identifier for a WebAuthn credential.
        - `model` string, required — The type of Authenticator device.
        - `credential` Externaldatav1Credential, required
          - `publicKey` string, required — The public component of a cryptographic key pair used to sign messages and transactions.
          - `type` 'CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR' | 'CREDENTIAL_TYPE_API_KEY_P256' | 'CREDENTIAL_TYPE_RECOVER_USER_KEY_P256' | 'CREDENTIAL_TYPE_API_KEY_SECP256K1' | 'CREDENTIAL_TYPE_EMAIL_AUTH_KEY_P256' | 'CREDENTIAL_TYPE_API_KEY_ED25519' | 'CREDENTIAL_TYPE_OTP_AUTH_KEY_P256' | 'CREDENTIAL_TYPE_READ_WRITE_SESSION_KEY_P256' | 'CREDENTIAL_TYPE_OAUTH_KEY_P256' | 'CREDENTIAL_TYPE_LOGIN', required
        - `authenticatorId` string, required — Unique identifier for a given Authenticator.
        - `authenticatorName` string, required — Human-readable name for an Authenticator.
        - `createdAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
        - `updatedAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
      - `apiKeys` V1ApiKey[], required — A list of API Key parameters. This field, if not needed, should be an empty array in your request body.
        - `credential` Externaldatav1Credential, required
          - `publicKey` string, required — The public component of a cryptographic key pair used to sign messages and transactions.
          - `type` 'CREDENTIAL_TYPE_WEBAUTHN_AUTHENTICATOR' | 'CREDENTIAL_TYPE_API_KEY_P256' | 'CREDENTIAL_TYPE_RECOVER_USER_KEY_P256' | 'CREDENTIAL_TYPE_API_KEY_SECP256K1' | 'CREDENTIAL_TYPE_EMAIL_AUTH_KEY_P256' | 'CREDENTIAL_TYPE_API_KEY_ED25519' | 'CREDENTIAL_TYPE_OTP_AUTH_KEY_P256' | 'CREDENTIAL_TYPE_READ_WRITE_SESSION_KEY_P256' | 'CREDENTIAL_TYPE_OAUTH_KEY_P256' | 'CREDENTIAL_TYPE_LOGIN', required
        - `apiKeyId` string, required — Unique identifier for a given API Key.
        - `apiKeyName` string, required — Human-readable name for an API Key.
        - `createdAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
        - `updatedAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
        - `expirationSeconds` string, uint64 — Optional window (in seconds) indicating how long the API Key should last.
      - `userTags` string[], required — A list of User Tag IDs.
      - `oauthProviders` V1OauthProvider[], required — A list of Oauth Providers.
        - `providerId` string, required — Unique identifier for an OAuth Provider
        - `providerName` string, required — Human-readable name to identify a Provider.
        - `issuer` string, required — The issuer of the token, typically a URL indicating the authentication server, e.g https://accounts.google.com
        - `audience` string, required — Expected audience ('aud' attribute of the signed token) which represents the app ID
        - `subject` string, required — Expected subject ('sub' attribute of the signed token) which represents the user ID
        - `createdAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
        - `updatedAt` Externaldatav1Timestamp, required
          - `seconds` string, required
          - `nanos` string, required
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
    - `policies` V1Policy[]
      - `policyId` string, required — Unique identifier for a given Policy.
      - `policyName` string, required — Human-readable name for a Policy.
      - `effect` 'EFFECT_ALLOW' | 'EFFECT_DENY', required
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `notes` string, required — Human-readable notes added by a User to describe a particular policy.
      - `consensus` string, required — A consensus expression that evalutes to true or false.
      - `condition` string, required — A condition expression that evalutes to true or false.
    - `privateKeys` V1PrivateKey[]
      - `privateKeyId` string, required — Unique identifier for a given Private Key.
      - `publicKey` string, required — The public component of a cryptographic key pair used to sign messages and transactions.
      - `privateKeyName` string, required — Human-readable name for a Private Key.
      - `curve` 'CURVE_SECP256K1' | 'CURVE_ED25519', required
      - `addresses` Externaldatav1Address[], required — Derived cryptocurrency addresses for a given Private Key.
        - `format` 'ADDRESS_FORMAT_UNCOMPRESSED' | 'ADDRESS_FORMAT_COMPRESSED' | 'ADDRESS_FORMAT_ETHEREUM' | 'ADDRESS_FORMAT_SOLANA' | 'ADDRESS_FORMAT_COSMOS' | 'ADDRESS_FORMAT_TRON' | 'ADDRESS_FORMAT_SUI' | 'ADDRESS_FORMAT_APTOS' | 'ADDRESS_FORMAT_BITCOIN_MAINNET_P2PKH' | 'ADDRESS_FORMAT_BITCOIN_MAINNET_P2SH' | 'ADDRESS_FORMAT_BITCOIN_MAINNET_P2WPKH' | 'ADDRESS_FORMAT_BITCOIN_MAINNET_P2WSH' | 'ADDRESS_FORMAT_BITCOIN_MAINNET_P2TR' | 'ADDRESS_FORMAT_BITCOIN_TESTNET_P2PKH' | 'ADDRESS_FORMAT_BITCOIN_TESTNET_P2SH' | 'ADDRESS_FORMAT_BITCOIN_TESTNET_P2WPKH' | 'ADDRESS_FORMAT_BITCOIN_TESTNET_P2WSH' | 'ADDRESS_FORMAT_BITCOIN_TESTNET_P2TR' | 'ADDRESS_FORMAT_BITCOIN_SIGNET_P2PKH' | 'ADDRESS_FORMAT_BITCOIN_SIGNET_P2SH' | 'ADDRESS_FORMAT_BITCOIN_SIGNET_P2WPKH' | 'ADDRESS_FORMAT_BITCOIN_SIGNET_P2WSH' | 'ADDRESS_FORMAT_BITCOIN_SIGNET_P2TR' | 'ADDRESS_FORMAT_BITCOIN_REGTEST_P2PKH' | 'ADDRESS_FORMAT_BITCOIN_REGTEST_P2SH' | 'ADDRESS_FORMAT_BITCOIN_REGTEST_P2WPKH' | 'ADDRESS_FORMAT_BITCOIN_REGTEST_P2WSH' | 'ADDRESS_FORMAT_BITCOIN_REGTEST_P2TR' | 'ADDRESS_FORMAT_SEI' | 'ADDRESS_FORMAT_XLM' | 'ADDRESS_FORMAT_DOGE_MAINNET' | 'ADDRESS_FORMAT_DOGE_TESTNET' | 'ADDRESS_FORMAT_TON_V3R2' | 'ADDRESS_FORMAT_TON_V4R2' | 'ADDRESS_FORMAT_TON_V5R1' | 'ADDRESS_FORMAT_XRP'
        - `address` string
      - `privateKeyTags` string[], required — A list of Private Key Tag IDs.
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `exported` boolean, required — True when a given Private Key is exported, false otherwise.
      - `imported` boolean, required — True when a given Private Key is imported, false otherwise.
    - `invitations` V1Invitation[]
      - `invitationId` string, required — Unique identifier for a given Invitation object.
      - `receiverUserName` string, required — The name of the intended Invitation recipient.
      - `receiverEmail` string, required — The email address of the intended Invitation recipient.
      - `receiverUserTags` string[], required — A list of tags assigned to the Invitation recipient.
      - `accessType` 'ACCESS_TYPE_WEB' | 'ACCESS_TYPE_API' | 'ACCESS_TYPE_ALL', required
      - `status` 'INVITATION_STATUS_CREATED' | 'INVITATION_STATUS_ACCEPTED' | 'INVITATION_STATUS_REVOKED', required
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `senderUserId` string, required — Unique identifier for the Sender of an Invitation.
    - `tags` Datav1Tag[]
      - `tagId` string, required — Unique identifier for a given Tag.
      - `tagName` string, required — Human-readable name for a Tag.
      - `tagType` 'TAG_TYPE_USER' | 'TAG_TYPE_PRIVATE_KEY', required
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
    - `rootQuorum` Externaldatav1Quorum
      - `threshold` integer, required — Count of unique approvals required to meet quorum.
      - `userIds` string[], required — Unique identifiers of quorum set members.
    - `features` V1Feature[]
      - `name` 'FEATURE_NAME_ROOT_USER_EMAIL_RECOVERY' | 'FEATURE_NAME_WEBAUTHN_ORIGINS' | 'FEATURE_NAME_EMAIL_AUTH' | 'FEATURE_NAME_EMAIL_RECOVERY' | 'FEATURE_NAME_WEBHOOK' | 'FEATURE_NAME_SMS_AUTH' | 'FEATURE_NAME_OTP_EMAIL_AUTH' | 'FEATURE_NAME_AUTH_PROXY'
      - `value` string
    - `wallets` V1Wallet[]
      - `walletId` string, required — Unique identifier for a given Wallet.
      - `walletName` string, required — Human-readable name for a Wallet.
      - `createdAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `updatedAt` Externaldatav1Timestamp, required
        - `seconds` string, required
        - `nanos` string, required
      - `exported` boolean, required — True when a given Wallet is exported, false otherwise.
      - `imported` boolean, required — True when a given Wallet is imported, false otherwise.
    - `smartContractInterfaceReferences` V1SmartContractInterfaceReference[]
      - `smartContractInterfaceId` string
      - `smartContractAddress` string
      - `digest` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.dev/turnkey/apis/api-reference.md) · [All operations](https://skmtc.dev/turnkey/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/turnkey/api-reference/revisions/4d8a7c63c511/schema)
