curl --request GET \
--url "https://api.rafflesia.ai/v1/homology/databases/{database_id}/releases?limit=20" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY"
{
"data": [
{
"aliases": [
"<string>"
],
"corpus_snapshot_id": "<string>",
"database_id": "<string>",
"homology_search_capability": {
"billable_formula_id": "tomato.object_reads_plus_logical_mib.v1",
"evidence": [
"candidate_measurement"
],
"guarantees": [
"approximate"
],
"maximum_results": 1,
"query_kinds": [
"protein_sequence"
],
"significance": {
"requirements": [
"not_requested"
],
"status": "available",
"calibration_scope": "release",
"unavailable_reason": "<string>"
},
"status": "available",
"filter_schema": {
"database_release_id": "<string>",
"fields": [
{
"field_type": "string",
"name": "<string>",
"operators": [
"<string>"
]
}
],
"id": "<string>",
"limits": {
"maximum_bytes": 123,
"maximum_depth": 123,
"maximum_field_bytes": 123,
"maximum_nodes": 123,
"maximum_scalar_bytes": 123,
"maximum_values": 123
},
"metadata_manifest_sha256": "<string>",
"metadata_release_id": "<string>",
"missing_field_semantics": "turbopuffer",
"object": "<string>",
"search_policy_ids": [
"<string>"
],
"$schema": "https://example.com/schemas/HomologyFilterSchema.json"
},
"ranking": {
"comparability": "within_query_only",
"order": "ascending",
"primary_measurement": "maxsim.bidirectional",
"scope": "resolved_policy_frontier",
"tie_breakers": [
{
"field": "maxsim.bidirectional",
"order": "ascending"
}
]
},
"unavailable_reason": "<string>"
},
"id": "<string>",
"object": "homology_database_release",
"record_count": 1,
"residue_count": 1,
"status": "available",
"compiler_version": "<string>",
"corpus_published_at": "2023-11-07T05:31:56Z",
"manifest_sha256": "<string>"
}
],
"list_metadata": {
"after": "<string>",
"before": "<string>"
},
"object": "list",
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/HomologyDatabaseReleaseList.json"
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}Returns one cursor page of a database’s immutable releases, ordered by release id, each with its record and residue counts, its aliases, and the release-owned capability contract naming the search policies and evidence it can serve. A release id always identifies the same searched content. A release whose capability cannot currently be resolved is reported as unavailable with a warning rather than dropped from the page.
curl --request GET \
--url "https://api.rafflesia.ai/v1/homology/databases/{database_id}/releases?limit=20" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY"
{
"data": [
{
"aliases": [
"<string>"
],
"corpus_snapshot_id": "<string>",
"database_id": "<string>",
"homology_search_capability": {
"billable_formula_id": "tomato.object_reads_plus_logical_mib.v1",
"evidence": [
"candidate_measurement"
],
"guarantees": [
"approximate"
],
"maximum_results": 1,
"query_kinds": [
"protein_sequence"
],
"significance": {
"requirements": [
"not_requested"
],
"status": "available",
"calibration_scope": "release",
"unavailable_reason": "<string>"
},
"status": "available",
"filter_schema": {
"database_release_id": "<string>",
"fields": [
{
"field_type": "string",
"name": "<string>",
"operators": [
"<string>"
]
}
],
"id": "<string>",
"limits": {
"maximum_bytes": 123,
"maximum_depth": 123,
"maximum_field_bytes": 123,
"maximum_nodes": 123,
"maximum_scalar_bytes": 123,
"maximum_values": 123
},
"metadata_manifest_sha256": "<string>",
"metadata_release_id": "<string>",
"missing_field_semantics": "turbopuffer",
"object": "<string>",
"search_policy_ids": [
"<string>"
],
"$schema": "https://example.com/schemas/HomologyFilterSchema.json"
},
"ranking": {
"comparability": "within_query_only",
"order": "ascending",
"primary_measurement": "maxsim.bidirectional",
"scope": "resolved_policy_frontier",
"tie_breakers": [
{
"field": "maxsim.bidirectional",
"order": "ascending"
}
]
},
"unavailable_reason": "<string>"
},
"id": "<string>",
"object": "homology_database_release",
"record_count": 1,
"residue_count": 1,
"status": "available",
"compiler_version": "<string>",
"corpus_published_at": "2023-11-07T05:31:56Z",
"manifest_sha256": "<string>"
}
],
"list_metadata": {
"after": "<string>",
"before": "<string>"
},
"object": "list",
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/HomologyDatabaseReleaseList.json"
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}{
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"request_id": "<string>",
"type": "invalid_request_error",
"details": {},
"param": "<string>"
}
}Authorizations
A Rafflesia API key, sent as Authorization: Bearer <key>.
Headers
Optional dated contract pin. Omit to use the current 2026-08-08 homology contract; any other value returns api_version_unsupported.
Path Parameters
Query Parameters
1 <= x <= 100Return the page immediately before this opaque cursor. Mutually exclusive with after.
Return the page immediately after this opaque cursor. Mutually exclusive with before.
Response
OK
The releases in this page. Always an array, including for an empty page.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Always list.
list Execution provenance for this page.
Show child attributes
Show child attributes
Non-fatal warnings observed while producing this page. Always an array.
Show child attributes
Show child attributes
A URL to the JSON Schema for this object.
"https://example.com/schemas/HomologyDatabaseReleaseList.json"