Batch: Ensembl Plants Locus Metadata
batch_ensembl_plants_lookup_locusRead-onlyIdempotent
Look up multiple plant gene loci from Ensembl Plants in a single batch request, returning results or errors for each locus.
Instructions
Batch variant of ensembl_plants_lookup_locus. Uses Ensembl's native POST /lookup/id endpoint — one HTTP round-trip for up to 50 loci, materially cheaper than N parallel GETs. Successes in results[] with the same shape as the single-locus tool. Retries 429/5xx via the shared _http helper (Retry-After capped at 60 s). Misses (loci with no record) still land in errors[] with the [NotFoundError] prefix; the whole batch only fails when the retry budget is exhausted.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loci | Yes | List of locus identifiers (1–50). Successes land in results[locus]; PlantGenomicsError failures in errors[locus]. | |
| organism | No | Plant organism — accepts canonical slug (arabidopsis_thaliana), scientific or common name, or NCBI taxid | arabidopsis_thaliana |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tool | Yes | The batch tool name, e.g. batch_resolve_locus_to_uniprot | |
| count | Yes | Number of distinct loci queried, returned (== len(results) + len(errors)). The input list is de-duplicated first, so this is LOWER than the number of loci you sent if you sent a duplicate — that is de-duplication, not a dropped locus. | |
| errors | Yes | locus → '[ClassName] message' for PlantGenomicsError failures | |
| results | Yes | locus → per-locus result dict (same shape as the single-locus tool) |