Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

A Rafflesia API key, sent as Authorization: Bearer <key>.

Headers

Idempotency-Key
string

Optional retry identity retained for 24 hours for the complete all-or-nothing batch. Reuse the same key only with the same request. When omitted, each item in each HTTP request is a distinct billable operation.

Maximum string length: 255
Rafflesia-API-Version
string

Optional dated contract pin. Omit to use the current 2026-08-08 homology contract; any other value returns api_version_unsupported.

Body

application/json
queries
object[]
required

An ordered batch of 1 to 16 typed biological queries sharing every search control.

Required array length: 1 - 16 elements
database
string

Database id or slug from homology.databases.list. Omit both database selectors to use the server-advertised default database and its default release. Mutually exclusive with database_release_id.

Required string length: 1 - 256
database_release_id
string

Exact immutable dbr_ release id returned by the catalog. Omit both database selectors to use the server-advertised default database and its default release. Mutually exclusive with database.

Pattern: ^dbr_[0-9a-f]{64}$
evidence
enum<string>
default:pairwise_sequence_alignment
Available options:
candidate_measurement,
pairwise_sequence_alignment
filter
object

Optional exact metadata predicate applied before the release-owned search policy.

guarantee
enum<string>
default:approximate
Available options:
approximate,
exhaustive
limit
integer<int64>
default:25

Maximum ranked results returned inline for each query, additionally bounded by the selected immutable release. The aggregate may not exceed 10,000 candidate measurements or 1,000 pairwise alignments, and the encoded batch may not exceed 16 MiB.

Required range: 1 <= x <= 5000
significance
enum<string>
default:if_available
Available options:
not_requested,
if_available,
required
target_space_id
string

Immutable reusable target space returned as database.target_space_id by a prior filtered homology search and shared by every query. Mutually exclusive with database, database_release_id, and filter.

Pattern: ^htsp_[0-9a-f]{64}$

Response

OK

object
enum<string>
required

Always homology_search_result_set_batch.

Available options:
homology_search_result_set_batch
performance
object
required
request_id
string
required
responses
object[]
required
Required array length: 1 - 16 elements
result_sha256
string
required
usage
object
required
warnings
object[]
required

Non-fatal warnings. Always an array.