Returns the durable transport batch while it is retained. Expired batches return 410 rather than being disguised as missing.
GET
/
v1
/
homology
/
batches
/
{homology_batch_id}
Retrieve a durable batch of independent homology searches
curl --request GET \
--url https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"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": "<string>",
"data": {
"created_at": "<string>",
"data": [
{
"index": 123,
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"search": {
"created_at": "<string>",
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "<string>",
"policy_id": "<string>",
"query": {
"kind": "<string>",
"normalization_id": "<string>",
"normalized_length": 123,
"retention": "<string>",
"sha256": "<string>"
},
"receipt": {
"corpus_snapshot_id": "<string>",
"database_release_id": "<string>",
"engine": "<string>",
"execution_warnings": [
"<string>"
],
"is_deterministic": true,
"is_exhaustive": true,
"is_policy_complete": true,
"quality_evaluation_ids": [
"<string>"
],
"search_policy_id": "<string>",
"semantic_profile_id": "<string>",
"blueprint_capability_version": "<string>",
"blueprint_sha256": "<string>",
"calibration_id": "<string>",
"canonical_filter_sha256": "<string>",
"database_residue_count": 1,
"database_target_count": 1,
"engine_release": "<string>",
"execution_receipt_bytes": 1,
"execution_receipt_id": "<string>",
"execution_receipt_sha256": "<string>",
"filter_schema_id": "<string>",
"job_id": "<string>",
"query_bundle_id": "<string>",
"query_compilation_id": "<string>",
"result_sha256": "<string>",
"searched_residue_count": 1,
"searched_target_count": 1,
"semantic_profile_family_id": "<string>",
"semantic_profile_manifest_sha256": "<string>",
"submission_id": "<string>",
"target_bundle_id": "<string>",
"target_space_id": "<string>",
"usage": {
"logical_bytes_returned": 1,
"billable_formula_id": "<string>",
"billable_units": 1,
"logical_bytes_read": 1,
"object_reads": 1,
"query_pack_bytes": 1
},
"work": {
"returned_result_count": 1,
"affine_cells": 1,
"affine_pairs": 1,
"candidate_pairs": 1,
"maxsim_residue_pairs": 1,
"traceback_pairs": 1
}
},
"results": {
"max_results": 5000,
"significance_requirement": "not_requested",
"unit": "target"
},
"retention_class": "standard_30d",
"specification_sha256": "<string>",
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"result_set": {
"canonical_result_id": "<string>",
"count": 123,
"expires_at": "<string>",
"is_result_limit_reached": true,
"object": "<string>",
"sha256": "<string>",
"url": "<string>"
},
"target_space": {
"eligible_record_count": 123,
"eligible_residue_count": 123,
"id": "<string>",
"is_filtered": true,
"total_record_count": 123,
"unknown_record_count": 123,
"canonical_filter_sha256": "<string>",
"filter_schema_id": "<string>"
}
}
}
],
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "homology_batch",
"retention_class": "standard_30d"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"details": {},
"param": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"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": "<string>",
"data": {
"created_at": "<string>",
"data": [
{
"index": 123,
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"search": {
"created_at": "<string>",
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "<string>",
"policy_id": "<string>",
"query": {
"kind": "<string>",
"normalization_id": "<string>",
"normalized_length": 123,
"retention": "<string>",
"sha256": "<string>"
},
"receipt": {
"corpus_snapshot_id": "<string>",
"database_release_id": "<string>",
"engine": "<string>",
"execution_warnings": [
"<string>"
],
"is_deterministic": true,
"is_exhaustive": true,
"is_policy_complete": true,
"quality_evaluation_ids": [
"<string>"
],
"search_policy_id": "<string>",
"semantic_profile_id": "<string>",
"blueprint_capability_version": "<string>",
"blueprint_sha256": "<string>",
"calibration_id": "<string>",
"canonical_filter_sha256": "<string>",
"database_residue_count": 1,
"database_target_count": 1,
"engine_release": "<string>",
"execution_receipt_bytes": 1,
"execution_receipt_id": "<string>",
"execution_receipt_sha256": "<string>",
"filter_schema_id": "<string>",
"job_id": "<string>",
"query_bundle_id": "<string>",
"query_compilation_id": "<string>",
"result_sha256": "<string>",
"searched_residue_count": 1,
"searched_target_count": 1,
"semantic_profile_family_id": "<string>",
"semantic_profile_manifest_sha256": "<string>",
"submission_id": "<string>",
"target_bundle_id": "<string>",
"target_space_id": "<string>",
"usage": {
"logical_bytes_returned": 1,
"billable_formula_id": "<string>",
"billable_units": 1,
"logical_bytes_read": 1,
"object_reads": 1,
"query_pack_bytes": 1
},
"work": {
"returned_result_count": 1,
"affine_cells": 1,
"affine_pairs": 1,
"candidate_pairs": 1,
"maxsim_residue_pairs": 1,
"traceback_pairs": 1
}
},
"results": {
"max_results": 5000,
"significance_requirement": "not_requested",
"unit": "target"
},
"retention_class": "standard_30d",
"specification_sha256": "<string>",
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"result_set": {
"canonical_result_id": "<string>",
"count": 123,
"expires_at": "<string>",
"is_result_limit_reached": true,
"object": "<string>",
"sha256": "<string>",
"url": "<string>"
},
"target_space": {
"eligible_record_count": 123,
"eligible_residue_count": 123,
"id": "<string>",
"is_filtered": true,
"total_record_count": 123,
"unknown_record_count": 123,
"canonical_filter_sha256": "<string>",
"filter_schema_id": "<string>"
}
}
}
],
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "homology_batch",
"retention_class": "standard_30d"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"details": {},
"param": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"$schema": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}Authorizations
A Rafflesia API key, sent as Authorization: Bearer <key>.
Path Parameters
Response
OK
Whether the operation succeeded.
Execution provenance.
Show child attributes
Show child attributes
Non-fatal warnings.
Show child attributes
Show child attributes
A URL to the JSON Schema for this object.
Example:
"https://example.com/schemas/EnvelopeHomologyBatch.json"
Operation result data.
Show child attributes
Show child attributes
Structured error information.
Show child attributes
Show child attributes
Mechanical evidence summary for agent inspection and chaining.
Show child attributes
Show child attributes
Previous
List calibrations for an exact target space and search policyReturns immutable significance calibrations matching both caller-supplied scope identities. Discovery never selects a calibration for search.
Next
⌘I
Retrieve a durable batch of independent homology searches
curl --request GET \
--url https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.rafflesia.ai/v1/homology/batches/{homology_batch_id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"ok": true,
"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": "<string>",
"data": {
"created_at": "<string>",
"data": [
{
"index": 123,
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"search": {
"created_at": "<string>",
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "<string>",
"policy_id": "<string>",
"query": {
"kind": "<string>",
"normalization_id": "<string>",
"normalized_length": 123,
"retention": "<string>",
"sha256": "<string>"
},
"receipt": {
"corpus_snapshot_id": "<string>",
"database_release_id": "<string>",
"engine": "<string>",
"execution_warnings": [
"<string>"
],
"is_deterministic": true,
"is_exhaustive": true,
"is_policy_complete": true,
"quality_evaluation_ids": [
"<string>"
],
"search_policy_id": "<string>",
"semantic_profile_id": "<string>",
"blueprint_capability_version": "<string>",
"blueprint_sha256": "<string>",
"calibration_id": "<string>",
"canonical_filter_sha256": "<string>",
"database_residue_count": 1,
"database_target_count": 1,
"engine_release": "<string>",
"execution_receipt_bytes": 1,
"execution_receipt_id": "<string>",
"execution_receipt_sha256": "<string>",
"filter_schema_id": "<string>",
"job_id": "<string>",
"query_bundle_id": "<string>",
"query_compilation_id": "<string>",
"result_sha256": "<string>",
"searched_residue_count": 1,
"searched_target_count": 1,
"semantic_profile_family_id": "<string>",
"semantic_profile_manifest_sha256": "<string>",
"submission_id": "<string>",
"target_bundle_id": "<string>",
"target_space_id": "<string>",
"usage": {
"logical_bytes_returned": 1,
"billable_formula_id": "<string>",
"billable_units": 1,
"logical_bytes_read": 1,
"object_reads": 1,
"query_pack_bytes": 1
},
"work": {
"returned_result_count": 1,
"affine_cells": 1,
"affine_pairs": 1,
"candidate_pairs": 1,
"maxsim_residue_pairs": 1,
"traceback_pairs": 1
}
},
"results": {
"max_results": 5000,
"significance_requirement": "not_requested",
"unit": "target"
},
"retention_class": "standard_30d",
"specification_sha256": "<string>",
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"result_set": {
"canonical_result_id": "<string>",
"count": 123,
"expires_at": "<string>",
"is_result_limit_reached": true,
"object": "<string>",
"sha256": "<string>",
"url": "<string>"
},
"target_space": {
"eligible_record_count": 123,
"eligible_residue_count": 123,
"id": "<string>",
"is_filtered": true,
"total_record_count": 123,
"unknown_record_count": 123,
"canonical_filter_sha256": "<string>",
"filter_schema_id": "<string>"
}
}
}
],
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "homology_batch",
"retention_class": "standard_30d"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"details": {},
"param": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"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": "<string>",
"data": {
"created_at": "<string>",
"data": [
{
"index": 123,
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"search": {
"created_at": "<string>",
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "<string>",
"policy_id": "<string>",
"query": {
"kind": "<string>",
"normalization_id": "<string>",
"normalized_length": 123,
"retention": "<string>",
"sha256": "<string>"
},
"receipt": {
"corpus_snapshot_id": "<string>",
"database_release_id": "<string>",
"engine": "<string>",
"execution_warnings": [
"<string>"
],
"is_deterministic": true,
"is_exhaustive": true,
"is_policy_complete": true,
"quality_evaluation_ids": [
"<string>"
],
"search_policy_id": "<string>",
"semantic_profile_id": "<string>",
"blueprint_capability_version": "<string>",
"blueprint_sha256": "<string>",
"calibration_id": "<string>",
"canonical_filter_sha256": "<string>",
"database_residue_count": 1,
"database_target_count": 1,
"engine_release": "<string>",
"execution_receipt_bytes": 1,
"execution_receipt_id": "<string>",
"execution_receipt_sha256": "<string>",
"filter_schema_id": "<string>",
"job_id": "<string>",
"query_bundle_id": "<string>",
"query_compilation_id": "<string>",
"result_sha256": "<string>",
"searched_residue_count": 1,
"searched_target_count": 1,
"semantic_profile_family_id": "<string>",
"semantic_profile_manifest_sha256": "<string>",
"submission_id": "<string>",
"target_bundle_id": "<string>",
"target_space_id": "<string>",
"usage": {
"logical_bytes_returned": 1,
"billable_formula_id": "<string>",
"billable_units": 1,
"logical_bytes_read": 1,
"object_reads": 1,
"query_pack_bytes": 1
},
"work": {
"returned_result_count": 1,
"affine_cells": 1,
"affine_pairs": 1,
"candidate_pairs": 1,
"maxsim_residue_pairs": 1,
"traceback_pairs": 1
}
},
"results": {
"max_results": 5000,
"significance_requirement": "not_requested",
"unit": "target"
},
"retention_class": "standard_30d",
"specification_sha256": "<string>",
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"failure": {
"code": "<string>",
"detail": "<string>",
"is_retryable": true
},
"result_set": {
"canonical_result_id": "<string>",
"count": 123,
"expires_at": "<string>",
"is_result_limit_reached": true,
"object": "<string>",
"sha256": "<string>",
"url": "<string>"
},
"target_space": {
"eligible_record_count": 123,
"eligible_residue_count": 123,
"id": "<string>",
"is_filtered": true,
"total_record_count": 123,
"unknown_record_count": 123,
"canonical_filter_sha256": "<string>",
"filter_schema_id": "<string>"
}
}
}
],
"expires_at": "<string>",
"id": "<string>",
"idempotency_key_expires_at": "<string>",
"object": "homology_batch",
"retention_class": "standard_30d"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"message": "<string>",
"details": {},
"param": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"$schema": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}