> ## Documentation Index > Fetch the complete documentation index at: https://api.nektir.com/llms.txt > Use this file to discover all available pages before exploring further. # Get a reviewed brand and its search aliases > Returns the public reviewed alias set plus current product, family, category, and inventory-freshness summaries. ## OpenAPI ````yaml /openapi/v1.yaml get /brands/{brand_id} openapi: 3.1.0 info: title: Independent Utah DABS API version: 1.0.0 summary: Database-backed product, store, and reported-inventory reads description: > Version 1 pilot contract. All requests read a locally published database revision; no public request waits for or triggers Utah DABS. Reported quantities are observations, not purchase guarantees. This service is independent and is not affiliated with or endorsed by Utah DABS. The current local seed contains historical inventory fixtures; clients must inspect response warnings and coverage metadata. servers: - url: http://127.0.0.1:5185/v1 description: Local development only; set MINTLIFY_API_BASE_URL before publishing security: [] tags: - name: Products - name: Brands - name: Product families - name: Changes - name: Exports - name: Stores - name: Availability - name: Metadata paths: /brands/{brand_id}: get: tags: - Brands summary: Get a reviewed brand and its search aliases description: >- Returns the public reviewed alias set plus current product, family, category, and inventory-freshness summaries. operationId: getBrand parameters: - $ref: '#/components/parameters/BrandIdPath' - $ref: '#/components/parameters/IfNoneMatch' - $ref: '#/components/parameters/IfModifiedSince' responses: '200': description: Reviewed brand detail from one immutable publication revision. headers: ETag: $ref: '#/components/headers/ETag' Last-Modified: $ref: '#/components/headers/LastModified' Cache-Control: $ref: '#/components/headers/MetadataCacheControl' X-Publication-Revision: $ref: '#/components/headers/PublicationRevision' content: application/json: schema: $ref: '#/components/schemas/BrandResponse' '304': $ref: '#/components/responses/NotModified' '400': $ref: '#/components/responses/BadRequest' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/Unavailable' components: parameters: BrandIdPath: name: brand_id in: path required: true description: Stable API-owned reviewed brand UUID. schema: type: string format: uuid IfNoneMatch: name: If-None-Match in: header description: Strong entity tag from an earlier response. schema: type: string IfModifiedSince: name: If-Modified-Since in: header description: HTTP-date fallback validator. ETag takes precedence. schema: type: string headers: ETag: description: >- Strong validator for the response representation. A new publication may retain the validator when this response is unchanged. schema: type: string example: '"v1-018f2fd0-a3d4-7d20-9c11-9482722f6b26-a91c"' LastModified: description: >- Newest relevant publication time in HTTP-date format; not an upstream update time. schema: type: string example: Tue, 15 Sep 2026 16:31:00 GMT MetadataCacheControl: schema: type: string example: public, max-age=300, stale-while-revalidate=3600 PublicationRevision: description: Immutable API publication revision used for this representation. schema: type: string format: uuid RetryAfter: description: Seconds until retry or an HTTP-date. schema: type: string RequestId: description: >- Server-generated identifier for correlating a response with private operational logs. schema: type: string format: uuid schemas: BrandResponse: type: object additionalProperties: false required: - data - meta properties: data: $ref: '#/components/schemas/Brand' meta: $ref: '#/components/schemas/ResourceMeta' Brand: type: object additionalProperties: false required: - id - slug - name - product_count - family_count - category_ids - inventory_retrieved_at - aliases properties: id: type: string format: uuid slug: type: string name: type: string product_count: type: integer minimum: 1 family_count: type: integer minimum: 0 category_ids: type: array uniqueItems: true items: type: string pattern: ^cat_[a-z0-9_]+$ inventory_retrieved_at: type: - string - 'null' format: date-time aliases: type: array uniqueItems: true items: type: string description: >- Reviewed public search spellings; raw candidate or rejected mappings are never returned. ResourceMeta: type: object additionalProperties: false required: - warnings properties: freshness: $ref: '#/components/schemas/ProductResourceFreshness' warnings: type: array items: $ref: '#/components/schemas/Warning' Problem: type: object additionalProperties: false required: - type - title - status - detail - instance - code - request_id properties: type: type: string format: uri title: type: string status: type: integer minimum: 400 maximum: 599 detail: type: string instance: type: string format: uri-reference code: type: string request_id: type: string format: uuid invalid_params: type: array items: $ref: '#/components/schemas/InvalidParameter' ProductResourceFreshness: type: object additionalProperties: false required: - catalog - inventory properties: catalog: $ref: '#/components/schemas/NullableObservationTimes' inventory: type: object additionalProperties: false required: - source_updated_at - retrieved_at_min - retrieved_at_max - published_at - upstream_age_known properties: source_updated_at: type: - string - 'null' format: date-time retrieved_at_min: type: - string - 'null' format: date-time retrieved_at_max: type: - string - 'null' format: date-time published_at: type: - string - 'null' format: date-time upstream_age_known: type: boolean const: false Warning: type: object additionalProperties: false description: >- Machine-readable data qualification. Current codes include FIXTURE_DATA, INVENTORY_COVERAGE_PARTIAL, SOURCE_REFRESH_DELAYED, UPSTREAM_PRODUCT_UNAVAILABLE, SOURCE_SCHEMA_QUARANTINED, and CATALOG_BATCH_OLD. required: - code properties: code: type: string examples: - INVENTORY_COVERAGE_PARTIAL InvalidParameter: type: object additionalProperties: false required: - name - reason properties: name: type: string reason: type: string NullableObservationTimes: type: object additionalProperties: false required: - source_updated_at - retrieved_at - published_at properties: source_updated_at: type: - string - 'null' format: date-time retrieved_at: type: - string - 'null' format: date-time published_at: type: - string - 'null' format: date-time responses: NotModified: description: Representation has not changed for the supplied validator. headers: ETag: $ref: '#/components/headers/ETag' Cache-Control: description: Cache policy for the validated representation. schema: type: string X-Publication-Revision: $ref: '#/components/headers/PublicationRevision' BadRequest: description: Invalid parameters, incompatible scope, or cursor/query mismatch. headers: Cache-Control: schema: type: string example: no-store content: application/problem+json: schema: $ref: '#/components/schemas/Problem' NotFound: description: Published resource or source mapping not found. headers: Cache-Control: schema: type: string example: no-store content: application/problem+json: schema: $ref: '#/components/schemas/Problem' RateLimited: description: Public read-rate limit exceeded. headers: Cache-Control: schema: type: string example: no-store Retry-After: $ref: '#/components/headers/RetryAfter' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' InternalError: description: >- An unexpected server failure. Details are withheld; report the response request identifier. headers: Cache-Control: schema: type: string example: no-store X-Request-ID: $ref: '#/components/headers/RequestId' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' Unavailable: description: No safe published database revision is currently readable. headers: Cache-Control: schema: type: string example: no-store Retry-After: $ref: '#/components/headers/RetryAfter' content: application/problem+json: schema: $ref: '#/components/schemas/Problem' ````