casquery
Query the EPA Substance Registry Service (SRS) using CAS Registry Numbers (CASRN).
casquery provides:
- A command-line tool for searching CASRN records
- Normalization of messy CAS numbers
- CAS resolution (superseded → current CASRN)
- Batch processing of CSVs
- Multiple output formats (table, JSON, XML, CSV)
It works both as:
- A standalone script (
python casquery.py) - A PyPI-installable CLI (
casquery …)
Installation
# From PyPI
pip install casquery
# Or pip install git+
pip install "git+https://github.com/geocoug/casquery.git"
Command Line Usage
# Help
casquery --help
casquery search --help
# Search EPA SRS
casquery search 375-73-5 29420-43-3
# Search with synonyms
casquery search --synonyms 375-73-5
# Output formats
casquery search 375-73-5 --format json
casquery search 375-73-5 --format xml
casquery search 375-73-5 --format csv
# Normalize CAS numbers
casquery normalize 1234567
# → 1234-56-7
# Resolve superseded CAS numbers
casquery resolve 29420-43-3
# Batch-process a CSV (Input CSV must contain a column of CASRN values.)
casquery batch input.csv --column analyte_cas --output cleaned.csv
Examples
Search for two CAS numbers
casquery search 7440-66-6 7440097
╭───────────────────────────────────────────────╮
│ EPA SRS CASRN Search Results │
╰───────────────────────────────────────────────╯
cas_rn systematicName epaName currentCasNumber
--------- ------------------ ---------- -----------------
7440-66-6 Zinc Zinc 7440-66-6
7440-09-7 Potassium Potassium 7440-09-7
Output JSON instead of a table
casquery search --format json 7440-66-6 7440-09-7
[
{
"cas_rn": "7440-09-7",
"systematicName": "Potassium",
"epaName": "Potassium",
"currentCasNumber": "7440-09-7"
},
{
"cas_rn": "7440-66-6",
"systematicName": "Zinc",
"epaName": "Zinc",
"currentCasNumber": "7440-66-6"
}
]
Metadata
Release files for casquery 0.2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| casquery-0.2.3.tar.gz | 22.3 kB | With provenance | Details for casquery-0.2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| casquery-0.2.3-py3-none-any.whl | Python 3 | none | any | Details for casquery-0.2.3-py3-none-any.whl |
Total release size: 41.4 kB
Release files / casquery-0.2.3.tar.gz
| Download URL | casquery-0.2.3.tar.gz |
|---|---|
| Size | 22.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3c933712dacdea6b3530b5529ebef2bc6fb27258e9a2b14198a646e43dc81b17
|
|
BLAKE2b-256 checksum How to use checksums |
0250ad993e1ad63cce2dba55e922f88eebcccb29717bf4fa1f35637e20788b77
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2025.
Transparency logRelease files / casquery-0.2.3-py3-none-any.whl
| Download URL | casquery-0.2.3-py3-none-any.whl |
|---|---|
| Size | 19.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
87cad32a4f600416ea2a656d0f1a00420d82ac6ccb313602ee517aa8c3fe2d73
|
|
BLAKE2b-256 checksum How to use checksums |
f9671404d322e2b7d4c7471e0e092a48555916bf94e1b71424013f44d7b0ada0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2025.
Transparency logSecurity for casquery 0.2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for casquery-0.2.3.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 20, 2025.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.