> ## 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 browsing metadata and coverage definitions ## OpenAPI ````yaml /openapi/v1.yaml get /meta 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: Stores - name: Metadata paths: /meta: get: tags: - Metadata summary: Get browsing metadata and coverage definitions operationId: getMetadata parameters: - $ref: '#/components/parameters/IfNoneMatch' - $ref: '#/components/parameters/IfModifiedSince' responses: '200': description: Current public metadata. 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/MetadataResponse' '304': $ref: '#/components/responses/NotModified' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/Unavailable' components: parameters: 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: MetadataResponse: type: object additionalProperties: false required: - data - meta properties: data: $ref: '#/components/schemas/Metadata' meta: $ref: '#/components/schemas/ResourceMeta' Metadata: type: object additionalProperties: false required: - categories - brands - statuses - availability_values - purchase_eligibility_values - dabs_flag_filters - product_sort_values - store_sort_values - limits - retrieval_policies - catalog_universes properties: categories: type: array items: $ref: '#/components/schemas/Category' brands: type: array items: $ref: '#/components/schemas/BrandMetadata' statuses: type: array items: $ref: '#/components/schemas/StatusMetadata' availability_values: type: array items: type: string enum: - any - reported_positive - checked purchase_eligibility_values: type: array items: $ref: '#/components/schemas/PublishedPurchaseEligibility' dabs_flag_filters: type: array items: $ref: '#/components/schemas/DabsFlagFilterMetadata' product_sort_values: type: array items: type: string store_sort_values: type: array items: type: string limits: type: object additionalProperties: false required: - default_page_size - maximum_page_size - maximum_store_ids - maximum_brand_ids - cursor_ttl_seconds properties: default_page_size: type: integer maximum_page_size: type: integer maximum_store_ids: type: integer maximum_brand_ids: type: integer cursor_ttl_seconds: type: integer retrieval_policies: type: array items: $ref: '#/components/schemas/RetrievalPolicy' catalog_universes: type: array items: $ref: '#/components/schemas/CatalogUniverse' ResourceMeta: type: object additionalProperties: false required: - warnings properties: 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' Category: type: object additionalProperties: false required: - id - parent_id - name - source_mappings properties: id: type: string pattern: ^cat_[a-z0-9_]+$ parent_id: type: - string - 'null' name: type: string source_mappings: type: array items: type: object additionalProperties: false required: - level - code - name_raw properties: level: type: string enum: - division - department - class - display_group code: type: string name_raw: type: string BrandMetadata: type: object additionalProperties: false required: - id - slug - name - product_count properties: id: type: string format: uuid slug: type: string name: type: string product_count: type: integer minimum: 1 StatusMetadata: type: object additionalProperties: false required: - code - label - lifecycle - ordinary_consumer_default properties: code: type: string label: type: string lifecycle: type: string enum: - active - discontinued - restricted - unavailable - unknown ordinary_consumer_default: $ref: '#/components/schemas/PublishedPurchaseEligibility' PublishedPurchaseEligibility: type: string enum: - eligible - restricted - unavailable - unknown DabsFlagFilterMetadata: type: object additionalProperties: false required: - parameter - source_field - semantics properties: parameter: type: string enum: - dabs_new_item - dabs_on_spa source_field: type: string enum: - newItem - onSpa semantics: type: string const: source_flag_unverified RetrievalPolicy: type: object additionalProperties: false required: - id - max_age_seconds - upstream_age_known - description properties: id: type: string max_age_seconds: type: integer minimum: 1 upstream_age_known: type: boolean const: false description: type: string CatalogUniverse: type: object additionalProperties: false required: - id - label - product_count - source_updated_at - retrieved_at_min - retrieved_at_max - published_at - collection_state - definition properties: id: type: string label: type: string product_count: type: integer minimum: 0 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 collection_state: type: string enum: - complete_batch - document_artifact - unknown definition: type: string 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 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' 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' ````