Skills › Scientific Agent Skills › database-lookup › hca.md
hca.md
44 lines · skills/database-lookup/references/hca.md at 5f2bc03
Human Cell Atlas (HCA)
Raw lines 1 to 211## Select the catalogue
13GET `/index/catalogs` and choose `default_catalog` or an explicitly required
14catalogue from `catalogs`. The live default on 2026-09-30 was `dcp60`; pin the
15returned name for the entire retrieval. Do not hard-code the old `dcp2` catalogue.
Select the catalogue
GET /index/catalogs and choose default_catalog or an explicitly required catalogue from catalogs. The live default on 2026-09-30 was dcp60; pin the returned name for the entire retrieval. Do not hard-code the old dcp2 catalogue.
17## Key Endpoints
19| Endpoint | Description |
20|----------|-------------|
21| `/index/projects?size={n}&catalog={catalog}` | List/search projects |
22| `/index/samples?size={n}&catalog={catalog}` | List/search samples |
23| `/index/files?size={n}&catalog={catalog}` | List/search files |
24| `/index/summary?catalog={catalog}` | Summary statistics |
Key Endpoints
| Endpoint | Description |
|---|---|
/index/projects?size={n}&catalog={catalog} | List/search projects |
/index/samples?size={n}&catalog={catalog} | List/search samples |
/index/files?size={n}&catalog={catalog} | List/search files |
/index/summary?catalog={catalog} | Summary statistics |
26## Example Calls
27```
28# List projects
29https://service.azul.data.humancellatlas.org/index/projects?size=5&catalog={catalog}
31# Summary stats
32https://service.azul.data.humancellatlas.org/index/summary?catalog={catalog}
33```
35Encode `filters` as JSON, for example `{"organ":{"is":["lung"]}}`.
36Follow `pagination.next` for continuation; the API uses search-after tokens,
37not a general numeric offset. Query parameters and filter names are defined in
38the [OpenAPI schema](https://service.azul.data.humancellatlas.org/openapi.json).
Example Calls
# List projects
https://service.azul.data.humancellatlas.org/index/projects?size=5&catalog={catalog}
# Summary stats
https://service.azul.data.humancellatlas.org/index/summary?catalog={catalog}Encode filters as JSON, for example {"organ":{"is":["lung"]}}. Follow pagination.next for continuation; the API uses search-after tokens, not a general numeric offset. Query parameters and filter names are defined in the OpenAPI schema.