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

# Get organization brands

> Returns the brands that belong to the organization. Requires organization-level authentication.



## OpenAPI

````yaml get /v1/organizations/{organizationId}/brands
openapi: 3.0.0
info:
  title: Way Partner API
  description: >-
    REST API for Way partners: list experiences, check availability, run
    checkout, and manage bookings.
  version: '1.0'
servers:
  - url: https://api.letsway.com
    description: Production.
  - url: https://api.staging.letsway.com
    description: Staging.
security: []
tags:
  - name: Listings
    description: 'Retrieve the listings a brand offers: experiences, events, and resources.'
  - name: Availability
    description: Dates, sessions, and price tiers for scheduling a booking.
  - name: Carts & Checkout
    description: >-
      Payment intents and booking creation. The cart ID is a client-generated
      UUID; there is no create-cart endpoint.
  - name: Bookings
    description: Retrieve, cancel, and reschedule bookings.
  - name: Experiences
    description: Experience details, settings, custom questions, reviews, and hosts.
  - name: Brand Configuration
    description: Brand settings, taxonomy, terms, and promotion code validation.
  - name: Waitlists
    description: Waitlists for sold-out sessions and invitation handling.
  - name: Integrations
    description: Configured integrations, analytics, and room-charge validation.
  - name: Organizations
    description: Organization-level access across brands.
paths:
  /v1/organizations/{organizationId}/brands:
    get:
      tags:
        - Organizations
      summary: Get organization brands
      description: >-
        Returns the brands that belong to the organization. Requires
        organization-level authentication.
      operationId: OrganizationPublicController_findAllPaginated
      parameters:
        - $ref: '#/components/parameters/organizationIdPath'
        - $ref: '#/components/parameters/limitQuery_73'
        - $ref: '#/components/parameters/pageQuery_74'
        - $ref: '#/components/parameters/sortByQuery_75'
        - $ref: '#/components/parameters/sortDirQuery_76'
      responses:
        '200':
          description: Brands.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BrandPaginatedResponseDto'
              example:
                items:
                  - id: b91e63ed-026c-4bd1-ae92-c910f20b9aa0
                    name: The City Hotel
                    tier: growth
                    countryCode: US
                    currency: USD
                    creditCardFeePercentage: 2.9
                    isTestBrand: false
                    isCuratedBrand: false
                    churnedAt: null
                    organizationId: 94a6fbf3-586f-42fb-b52a-90fa962bc4d7
                    products:
                      - host
                      - activate
                      - reserve
                    emailAddress: alice@example.com
                    csmUser: null
                    logoUri: null
                    deletedAt: null
      security:
        - Organization-API-Key: []
components:
  parameters:
    organizationIdPath:
      name: organizationId
      in: path
      schema:
        type: string
      required: true
      description: Only bookings belonging to this organization.
    limitQuery_73:
      name: limit
      in: query
      schema:
        minimum: 1
        default: 10
        type: number
      description: Number of items per page.
      example: 10
      required: false
    pageQuery_74:
      name: page
      in: query
      schema:
        minimum: 1
        default: 1
        type: number
      example: 1
      description: Page number to return, starting at 1.
      required: false
    sortByQuery_75:
      name: sortBy
      in: query
      schema:
        type: string
        enum:
          - name
          - emailAddress
          - tier
          - creditCardFeePercentage
      description: Field to sort the results by.
      required: false
    sortDirQuery_76:
      name: sortDir
      in: query
      schema:
        type: string
        enum:
          - ASC
          - DESC
      description: Sort direction.
      required: false
  schemas:
    BrandPaginatedResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/BrandDto'
          description: The organization's brands for the requested page.
        meta:
          $ref: '#/components/schemas/MetaDto'
        links:
          $ref: '#/components/schemas/LinksDto'
      required:
        - items
        - meta
    BrandDto:
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique identifier of the brand. Use it as the brandId path parameter
            in brand-scoped requests, or as the Way-Brand-Id header to scope an
            organization key to this brand.
          example: b91e63ed-026c-4bd1-ae92-c910f20b9aa0
        name:
          type: string
          description: Display name of the brand.
          example: City Hotel
        emailAddress:
          type: string
          description: Primary contact email address of the brand.
          example: concierge@cityhotel.com
        organizationId:
          type: object
          description: >-
            Identifier of the organization the brand belongs to. Null when the
            brand is not assigned to an organization.
          example: 94a6fbf3-586f-42fb-b52a-90fa962bc4d7
        countryCode:
          type: string
          enum:
            - US
            - GB
            - BR
          description: ISO 3166-1 alpha-2 country code of the brand.
          example: US
        currency:
          type: string
          description: ISO 4217 currency code used for the brand's pricing.
          example: USD
        tier:
          type: string
          enum:
            - growth
            - pro
            - starter
            - standard
            - custom
          description: Way subscription plan the brand is on.
          example: growth
        products:
          type: array
          items:
            type: string
            enum:
              - host
              - activate
              - reserve
            example: host
          description: >-
            Way product lines enabled for the brand, such as host, activate, and
            reserve.
        creditCardFeePercentage:
          type: number
          description: >-
            Credit card processing fee percentage applied to the brand's
            transactions, between 0 and 100.
          example: 3
        churnedAt:
          type: object
          description: ISO 8601 timestamp when the brand churned. Null for active brands.
          example: '2026-01-31T00:00:00.000Z'
        isTestBrand:
          type: object
          description: >-
            Whether the brand is a test brand rather than a live property. Null
            when not set.
          example: false
        isCuratedBrand:
          type: object
          description: >-
            Whether the brand is flagged as a curated brand in Way's curation
            program. Null when not set.
          example: false
        csmUser:
          $ref: '#/components/schemas/CsmUserDto'
        logoUri:
          type: object
          description: URL of the brand's logo image. Null when no logo has been uploaded.
          example: https://cdn.letsway.com/media/city-hotel-logo.png
        deletedAt:
          type: object
          description: >-
            ISO 8601 timestamp when the brand was deleted. Null for active
            brands.
          example: '2026-03-01T00:00:00.000Z'
      required:
        - id
        - name
        - emailAddress
        - countryCode
        - currency
        - tier
        - creditCardFeePercentage
    MetaDto:
      type: object
      properties:
        paymentStatus:
          description: Payment status details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentStatusDto'
        paymentDetail:
          description: Payment details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentDetailDto'
        paymentMethodDetail:
          description: Payment method details.
          nullable: true
          allOf:
            - $ref: '#/components/schemas/PaymentMethodDetailDto'
    LinksDto:
      type: object
      properties:
        first:
          type: string
          description: URL of the first page of results.
          example: >-
            https://api.letsway.com/v1/organizations/94a6fbf3-586f-42fb-b52a-90fa962bc4d7/brands?page=1&limit=10
        previous:
          type: string
          description: URL of the previous page of results. Omitted on the first page.
          example: >-
            https://api.letsway.com/v1/organizations/94a6fbf3-586f-42fb-b52a-90fa962bc4d7/brands?page=1&limit=10
        next:
          type: string
          description: URL of the next page of results. Omitted on the last page.
          example: >-
            https://api.letsway.com/v1/organizations/94a6fbf3-586f-42fb-b52a-90fa962bc4d7/brands?page=2&limit=10
        last:
          type: string
          description: URL of the last page of results.
          example: >-
            https://api.letsway.com/v1/organizations/94a6fbf3-586f-42fb-b52a-90fa962bc4d7/brands?page=5&limit=10
    CsmUserDto:
      type: object
      properties:
        id:
          type: string
          description: >-
            Unique identifier of the customer success manager assigned to the
            brand.
          example: 6f5e4d3c-2b1a-4098-8765-4321fedcba98
        firstName:
          type: string
          description: First name of the customer success manager.
          example: Jordan
        lastName:
          type: string
          description: Last name of the customer success manager.
          example: Lee
      required:
        - id
        - firstName
        - lastName
    PaymentStatusDto:
      type: object
      properties:
        code:
          type: string
          description: Payment status code.
          example: SUCCESS
        message:
          type: string
          description: Payment status message.
          example: Payment completed successfully
      required:
        - code
        - message
    PaymentDetailDto:
      type: object
      properties:
        lastName:
          type: string
          description: Last name on the payment method.
          example: Doe
          nullable: true
        methodNumber:
          type: string
          description: Payment method number.
          example: '**** **** **** 1234'
          nullable: true
        reservationId:
          type: string
          description: Reservation ID associated with payment.
          example: RES-456
          nullable: true
        confirmationId:
          type: string
          description: Confirmation ID of the payment.
          example: CONF-789
          nullable: true
    PaymentMethodDetailDto:
      type: object
      properties:
        fixedChargeId:
          type: string
          description: Fixed charge ID.
          example: CHG-123
          nullable: true
        billingChargeId:
          type: string
          description: Billing charge ID.
          example: BILL-456
          nullable: true
        transactionCode:
          type: object
          description: Transaction code details.
          example:
            code: T123
            description: Credit Card.
  securitySchemes:
    Organization-API-Key:
      type: http
      scheme: bearer
      description: >-
        Your organization's secret API key, e.g. `Bearer
        way_sk_live_ohEqcn0i1fRoUEHBPjJkQA`. Older `Way-Organization-Id` +
        `Way-Secret-Key` credentials still work: see [Legacy
        authentication](/legacy-authentication).

````