> ## 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 categories > Returns the brand's experience categories, localized when a `language` is passed. ## OpenAPI ````yaml get /v1/brands/{brandId}/categories 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/brands/{brandId}/categories: get: tags: - Brand Configuration summary: Get categories description: >- Returns the brand's experience categories, localized when a `language` is passed. operationId: CategoryPublicController_getCategories parameters: - $ref: '#/components/parameters/brandIdPath_58' - $ref: '#/components/parameters/languageQuery_59' - $ref: '#/components/parameters/productQuery' - $ref: '#/components/parameters/searchQuery' responses: '200': description: Get categories. content: application/json: schema: $ref: '#/components/schemas/ItemsCategoriesDto' example: items: - brandId: f2ce0a06-7997-4626-9532-65ac70f3a19c id: a3a98c9c-99fb-46ae-8586-d27ee8899c02 name: Recreation order: 1 createdAt: '2024-04-22T23:18:24.166Z' updatedAt: '2024-04-22T23:18:24.166Z' deletedAt: null - brandId: f2ce0a06-7997-4626-9532-65ac70f3a19c id: c80c38ad-7379-42b0-ae92-bc26de382a0b name: Family order: 2 createdAt: '2025-07-24T18:30:46.945Z' updatedAt: '2025-07-24T18:30:46.945Z' deletedAt: null security: - Brand-API-Key: [] - Organization-API-Key: [] components: parameters: brandIdPath_58: name: brandId in: path schema: type: string required: true description: >- The brand's ID - must match the brand your API key identifies (or the Way-Brand-Id header when one is sent). languageQuery_59: name: language in: query schema: type: string description: Locale for translated content; defaults to the brand's language. required: false productQuery: name: product in: query schema: type: string description: Only categories belonging to this product line. required: false searchQuery: name: search in: query schema: type: string description: Free-text filter by name. example: spa required: false schemas: ItemsCategoriesDto: type: object properties: items: description: List of items. type: array items: $ref: '#/components/schemas/CategoryDto' required: - items CategoryDto: type: object properties: id: type: string description: The unique identifier of the category. example: d7e1a35e-99b1-4a7e-8b9a-3f1d1d05ef9c name: type: string description: The name of the category. example: Electronics order: type: object description: The order of the category. example: 1 listings: description: List of associated listings. type: array items: $ref: '#/components/schemas/ListingDto' required: - id - name ListingDto: type: object properties: id: type: string description: The unique identifier of the listing. example: listing-123 brandId: type: object description: Brand ID associated with the listing. example: brand-456 externalBrandReferenceId: type: object description: External brand reference ID. example: external-brand-789 categoryId: type: object description: Category ID associated with the listing. example: category-123 locationId: type: object description: Location ID associated with the listing. example: location-456 experienceId: type: object description: Experience ID if applicable. example: experience-789 resourceGroupCollectionId: type: object description: Resource group collection ID. example: collection-123 kind: type: string description: The type of listing. enum: - experience - resource example: experience productLine: type: string description: The product line associated with the listing. enum: - host - activate - reserve example: host title: type: object description: Title of the listing. example: Luxury Yacht Tour description: type: object description: Description of the listing. example: Enjoy a premium yacht experience startingPrice: type: object description: Starting price of the listing. example: 250.99 pricePerType: type: object description: Type of pricing (e.g., per participant, per group) example: per participant minParticipants: type: object description: Minimum number of participants required. example: 2 maxParticipants: type: object description: Maximum number of participants allowed. example: 10 order: type: object description: Order of the listing in sorting. example: 1 featuredOrder: type: object description: Featured order for promotion. example: 2 coverMediaId: type: object description: Cover media ID. example: media-123 status: type: string description: Listing status. enum: - active - inactive - draft example: active summary: type: object description: Short summary of the listing. example: A fantastic experience at sea mediaIds: description: List of associated media IDs. example: - media-1 - media-2 type: array items: type: string vibeIds: description: List of associated vibe IDs. example: - vibe-1 - vibe-2 type: array items: type: string startTimes: description: List of available start times. example: - '10:00:00' - '14:00:00' type: array items: type: string cancellationPolicyId: type: object description: Cancellation policy ID. example: policy-123 createdAt: format: date-time type: string description: Timestamp when the listing was created. example: '2024-03-01T12:00:00Z' updatedAt: format: date-time type: string description: Timestamp when the listing was last updated. example: '2024-03-05T15:30:00Z' required: - id - kind - productLine - mediaIds - vibeIds - startTimes - createdAt - updatedAt securitySchemes: Brand-API-Key: type: http scheme: bearer description: >- Your brand's secret API key, e.g. `Bearer way_sk_live_bhEqcn0i1fRoUEHBPjJkQA`. Older `Way-Brand-Id` + `Way-Secret-Key` credentials still work: see [Legacy authentication](/legacy-authentication). 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). ````