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

# Get a release's immutable homology filter schema

> Returns the exact metadata fields, operators, limits, missing-field semantics, and search policies available when filtering one immutable homology database release. A release without a filter schema returns a structured error instead of silently ignoring the filter.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/homology/releases/{database_release_id}/filter-schema
openapi: 3.1.0
info:
  description: >-
    Deterministic biological evidence primitives. Every response is the same
    envelope: ok, data, warnings, provenance.
  title: Rafflesia API
  version: 0.1.0
servers:
  - description: Production
    url: https://api.rafflesia.ai
security:
  - bearerAuth: []
paths:
  /v1/homology/releases/{database_release_id}/filter-schema:
    get:
      tags:
        - Homology
      summary: Get a release's immutable homology filter schema
      description: >-
        Returns the exact metadata fields, operators, limits, missing-field
        semantics, and search policies available when filtering one immutable
        homology database release. A release without a filter schema returns a
        structured error instead of silently ignoring the filter.
      operationId: homology_filter_schemas_get
      parameters:
        - in: path
          name: database_release_id
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyFilterSchema'
          description: OK
          headers:
            Rafflesia-API-Version:
              schema:
                type: string
            Rafflesia-Contract-Digest:
              schema:
                type: string
            X-Request-ID:
              schema:
                type: string
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Not Found
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Unprocessable Entity
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Too Many Requests
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Internal Server Error
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HomologyErrorResponse'
          description: Service Unavailable
      x-codeSamples:
        - lang: bash
          source: |
            curl --request GET \
              --url "https://api.rafflesia.ai/v1/homology/releases/{database_release_id}/filter-schema" \
              --header "Authorization: Bearer $RAFFLESIA_API_KEY"
components:
  schemas:
    HomologyFilterSchema:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
            - https://example.com/schemas/HomologyFilterSchema.json
          format: uri
          readOnly: true
          type: string
        database_release_id:
          type: string
        fields:
          items:
            $ref: '#/components/schemas/HomologyFilterField'
          type:
            - array
            - 'null'
        id:
          type: string
        limits:
          $ref: '#/components/schemas/HomologyFilterLimits'
        metadata_manifest_sha256:
          type: string
        metadata_release_id:
          type: string
        missing_field_semantics:
          enum:
            - strong_kleene
          type: string
        object:
          type: string
        search_policy_ids:
          items:
            type: string
          type:
            - array
            - 'null'
      required:
        - id
        - object
        - database_release_id
        - metadata_release_id
        - metadata_manifest_sha256
        - search_policy_ids
        - fields
        - missing_field_semantics
        - limits
      type: object
    HomologyErrorResponse:
      additionalProperties: false
      properties:
        error:
          $ref: '#/components/schemas/HomologyPublicError'
      required:
        - error
      type: object
    HomologyFilterField:
      additionalProperties: false
      properties:
        field_type:
          enum:
            - string
            - integer
            - boolean
            - string_array
          type: string
        name:
          type: string
        operators:
          items:
            type: string
          type:
            - array
            - 'null'
      required:
        - name
        - field_type
        - operators
      type: object
    HomologyFilterLimits:
      additionalProperties: false
      properties:
        maximum_bytes:
          format: int64
          type: integer
        maximum_depth:
          format: int64
          type: integer
        maximum_field_bytes:
          format: int64
          type: integer
        maximum_nodes:
          format: int64
          type: integer
        maximum_scalar_bytes:
          format: int64
          type: integer
        maximum_values:
          format: int64
          type: integer
      required:
        - maximum_bytes
        - maximum_nodes
        - maximum_values
        - maximum_depth
        - maximum_field_bytes
        - maximum_scalar_bytes
      type: object
    HomologyPublicError:
      additionalProperties: false
      properties:
        code:
          type: string
        details:
          additionalProperties: {}
          type: object
        doc_url:
          type: string
        message:
          type: string
        param:
          type: string
        request_id:
          type: string
        type:
          enum:
            - invalid_request_error
            - resource_missing
            - resource_expired
            - conflict_error
            - rate_limit_error
            - authentication_error
            - permission_error
            - billing_error
            - api_error
          type: string
      required:
        - type
        - code
        - message
        - request_id
        - doc_url
      type: object
  securitySchemes:
    bearerAuth:
      description: 'A Rafflesia API key, sent as `Authorization: Bearer <key>`.'
      scheme: bearer
      type: http

````