> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baselayer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Organization

> Gets and returns the Organization profile of a specific Organization.
The authenticated user must have the 'organizations:read' permission.
If the authenticated user is an Operator, they can access any Organizations' profile.
If the authenticated user is a User or an Organization, they can only access the profile of their own Organization.

Args:
    organization_id (uuid.UUID): The unique identifier of the Organization.
    auth_context (BaseAuthContext): The authentication context of the request.

Returns:
    The Organization's profile.



## OpenAPI

````yaml /api-reference/openapi.json get /organizations/{organization_id}
openapi: 3.1.0
info:
  title: baselayer-api-service
  version: 0.1.0
servers:
  - url: https://api.baselayer.com/
security: []
paths:
  /organizations/{organization_id}:
    get:
      tags:
        - Organization Management
      summary: Get Organization
      description: >-
        Gets and returns the Organization profile of a specific Organization.

        The authenticated user must have the 'organizations:read' permission.

        If the authenticated user is an Operator, they can access any
        Organizations' profile.

        If the authenticated user is a User or an Organization, they can only
        access the profile of their own Organization.


        Args:
            organization_id (uuid.UUID): The unique identifier of the Organization.
            auth_context (BaseAuthContext): The authentication context of the request.

        Returns:
            The Organization's profile.
      operationId: get_organization_organizations__organization_id__get
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Organization Id
      responses:
        '200':
          description: Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/v1.OrganizationDetailResponse'
            application/vnd.baselayer.v1+json:
              schema:
                $ref: '#/components/schemas/v1.OrganizationDetailResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    v1.OrganizationDetailResponse:
      description: >-
        An Organization plus its lien-filing configuration.


        Served by the standalone ``GET /organization`` (and its
        ``PATCH``/``PUT``),

        the org-management endpoints, the federation organization list, and the

        admin organization endpoints. The nested-in-user view (``/me``,

        ``/users/{id}``) and the federation summary use the lean

        ``OrganizationResponse`` instead — only the single-resource org views
        carry

        the lien-filing fields. (``webhooks_version`` lives on the lean base:
        the

        console reads it off the nested org.)
      properties:
        id:
          description: The unique identifier of the Organization.
          examples:
            - a3d9af02-e679-4c12-a9b2-220b6eb78e2d
          format: uuid
          title: Organization Identifier
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: The name of the Organization.
          examples:
            - The Avengers
          title: Organization Name
        domain_name:
          anyOf:
            - type: string
            - type: 'null'
          description: The domain name of the Organization.
          examples:
            - avengers.com
          title: Organization Domain Name
        type:
          $ref: '#/components/schemas/v1.OrganizationType'
          description: The type of the organization.
          title: Organization Type
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            An external identifier for referencing the Organization using the ID
            from a namespace in an external system.
          examples:
            - b2e3a6ff-2734-47ed-ba87-54647e3550bd
            - org_818sja7i
          title: External Identifier
        webhooks_version:
          $ref: '#/components/schemas/v1.WebhooksVersion'
          description: The version of Baselayer Webhooks the Organization utilizies.
          examples:
            - '2.0'
        federation:
          anyOf:
            - $ref: '#/components/schemas/v1.FederationResponse'
            - type: 'null'
          description: The Federation that the Organization belongs to (if any).
          examples:
            - email: stan-lee@marvel.com
              id: 6d54d5fe-2fcd-4b83-891b-32e9e99656d6
              name: Stan Lee
          title: Federation
        applications:
          description: The Applications belonging to the Organization.
          examples:
            - enabled: true
              external_id: null
              id: 865a6f00-b7d7-4451-a787-6b89ac935f92
              name: Avengers - Sandbox
              type: sandbox
            - enabled: false
              external_id: null
              id: aee180c8-ad54-474d-8046-87fd2ec176c6
              name: Avengers - Production
              type: production
          items:
            $ref: '#/components/schemas/v1.ApplicationResponse'
          title: Applications
          type: array
        lien_filing_correspondence_email:
          anyOf:
            - format: email
              type: string
            - type: 'null'
          default: null
          description: The email address for lien filing correspondence.
          examples:
            - lien-filing-email@example.com
          title: Lien Filing Correspondence Email
        lien_filing_secured_party:
          anyOf:
            - $ref: >-
                #/components/schemas/v1.LienFilingOrganizationSecuredPartyPreference
            - type: 'null'
          default: null
          description: The secured party for lien filing.
          title: Lien Filing Secured Party
        lien_filing_collateral_statement:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The collateral statement for lien filing.
          title: Lien Filing Collateral Statement
        lien_filing_collateral_statement_templates:
          description: The list of collateral statement templates for lien filing.
          items:
            $ref: '#/components/schemas/v1.LienFilingCollateralStatementTemplate'
          title: Lien Filing Collateral Statement Templates
          type: array
      required:
        - id
        - name
        - domain_name
        - type
        - external_id
        - webhooks_version
        - federation
        - applications
      title: OrganizationDetailResponse (v1)
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    v1.OrganizationType:
      enum:
        - neobank
        - community_bank
        - credit_union
        - regional_bank
        - national_bank
        - fintech
        - smb_lender
        - merchant_cash_advanced
        - processor
        - infrastructure
        - other
      title: OrganizationType
      type: string
    v1.WebhooksVersion:
      enum:
        - '0.8'
        - '1.0'
        - '2.0'
        - '2.0'
      title: WebhooksVersion
      type: string
    v1.FederationResponse:
      description: Represents a federation response.
      properties:
        id:
          description: The unique identifier of the federation.
          format: uuid
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The name of the federation.
          title: Name
        contact:
          anyOf:
            - $ref: '#/components/schemas/v1.ContactResponse'
            - type: 'null'
          default: null
          description: The contact for the federation.
      required:
        - id
      title: FederationResponse (v1)
      type: object
    v1.ApplicationResponse:
      description: Represents an application response.
      properties:
        id:
          description: The unique identifier of the application.
          format: uuid
          title: Application Identifier
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The name of the application.
          examples:
            - The Avengers
          title: Application Name
        type:
          $ref: '#/components/schemas/v1.ApplicationType'
          description: The type of Application.
          examples:
            - sandbox
            - production
          title: Application Type
        enabled:
          description: >-
            Whether or not the application is enabled for access via the API and
            Console.
          examples:
            - true
            - false
          title: Application Enabled
          type: boolean
        external_id:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: >-
            An identifier for referencing the application in an external
            namespace.
          title: External Identifier
      required:
        - id
        - type
        - enabled
      title: ApplicationResponse (v1)
      type: object
    v1.LienFilingOrganizationSecuredPartyPreference:
      description: |-
        An organization's stored default secured party for lien filings.

        This is the template applied to newly created drafts — not a persisted
        lien party row — so unlike the submission list item it carries no
        party id.
      properties:
        mailing_address:
          anyOf:
            - description: >-
                The mailing address for the lien filing party, excluding city,
                state, and postal code.
              examples:
                - 123 Main St
                - 456 Elm St Apt 101
                - 789 Pine St NW Suite 500
              maxLength: 128
              title: Mailing Address
              type: string
            - description: No mailing address is provided for the party.
              title: No Mailing Address
              type: 'null'
          default: null
          title: Mailing Address
        city:
          anyOf:
            - description: The city of the lien filing party's mailing address.
              examples:
                - Springfield
                - Metropolis
                - Gotham
              maxLength: 128
              title: City
              type: string
            - description: No city is provided for the party.
              title: No City
              type: 'null'
          default: null
          title: City
        state:
          anyOf:
            - $ref: '#/components/schemas/v1.StateAbbreviation'
              description: >-
                The state abbreviation of the lien filing party's mailing
                address.
              examples:
                - AL
                - CA
                - NY
              title: State
            - description: No state is provided for the party.
              title: No State
              type: 'null'
          default: null
          title: State
        postal_code:
          anyOf:
            - description: The postal code of the lien filing party's mailing address.
              examples:
                - '62701'
                - '90210'
                - '10001'
              maxLength: 16
              title: Postal Code
              type: string
            - description: No postal code is provided for the party.
              title: No Postal Code
              type: 'null'
          default: null
          title: Postal Code
        masked:
          anyOf:
            - description: >-
                A flag to indicate if the secured party should be masked when
                filing a lien.
              title: Masked
              type: boolean
            - description: The secured party is not masked when filing a lien.
              title: Not Masked
              type: 'null'
          default: null
          title: Masked
        is_assignor:
          anyOf:
            - description: Whether the secured party is the assignor of the lien.
              title: Is Assignor
              type: boolean
            - description: The assignor status of the secured party is not specified.
              title: Assignor Not Specified
              type: 'null'
          default: null
          title: Is Assignor
        organization_name:
          anyOf:
            - description: The name of the organization involved in the lien filing.
              examples:
                - Acme Inc
                - Globex Corporation
                - Initech LLC
              maxLength: 128
              title: Organization Name
              type: string
            - description: No organization name is provided for the party.
              title: No Organization Name
              type: 'null'
          default: null
          title: Organization Name
        organization_type:
          anyOf:
            - $ref: '#/components/schemas/v1.BusinessStructure'
              description: >-
                The type of organization involved in the lien filing, if
                applicable.
              title: Organization Type
            - description: No organization type is provided for the party.
              title: No Organization Type
              type: 'null'
          default: null
          title: Organization Type
        type:
          const: ORGANIZATION
          default: ORGANIZATION
          description: >-
            Specifies the party type as 'Organization' for the context of this
            lien filing, indicating that the party is an organization or entity
            rather than a person.
          title: Organization Party Type
          type: string
      required:
        - type
      title: LienFilingOrganizationSecuredPartyPreference (v1)
      type: object
    v1.LienFilingCollateralStatementTemplate:
      description: Represents a template for a collateral statement in a UCC-3 filing.
      properties:
        title:
          description: The title of the collateral statement option.
          title: Collateral Statement Title
          type: string
        text:
          description: The text of the collateral statement option.
          title: Collateral Statement Text
          type: string
      required:
        - title
        - text
      title: LienFilingCollateralStatementTemplate
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
    v1.ContactResponse:
      description: Represents a contact response.
      properties:
        id:
          description: The unique identifier of the contact.
          format: uuid
          title: Id
          type: string
        name:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The name of the contact.
          title: Name
        email:
          anyOf:
            - type: string
            - type: 'null'
          default: null
          description: The email of the contact.
          title: Email
      required:
        - id
      title: ContactResponse (v1)
      type: object
    v1.ApplicationType:
      enum:
        - sandbox
        - production
      title: ApplicationType
      type: string
    v1.StateAbbreviation:
      enum:
        - AL
        - AK
        - AZ
        - AR
        - CA
        - CO
        - CT
        - DE
        - DC
        - FL
        - GA
        - HI
        - ID
        - IL
        - IN
        - IA
        - KS
        - KY
        - LA
        - ME
        - MD
        - MA
        - MI
        - MN
        - MS
        - MO
        - MT
        - NE
        - NV
        - NH
        - NJ
        - NM
        - NY
        - NC
        - ND
        - OH
        - OK
        - OR
        - PA
        - RI
        - SC
        - SD
        - TN
        - TX
        - UT
        - VT
        - VA
        - WA
        - WV
        - WI
        - WY
        - PR
        - VI
        - AE
        - AA
        - AP
        - GU
        - AS
      title: StateAbbreviation
      type: string
    v1.BusinessStructure:
      enum:
        - SOLE_PROPRIETORSHIP
        - GENERAL_PARTNERSHIP
        - LLC
        - LLP
        - LLLP
        - LP
        - C_CORPORATION
        - S_CORPORATION
        - B_CORPORATION
        - NONPROFIT
        - COOPERATIVE
        - TRUST
        - PROFESSIONAL_ASSOCIATION
        - PROFESSIONAL_CORPORATION
        - TRADE_NAME
        - BANK
        - CREDIT_UNION
        - INSURANCE
        - OTHER
      title: BusinessStructure
      type: string
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````