---
name: 1stauthor-standards
description: The 1stAuthor standards domain.
---

# 1stAuthor Standards

Catalogue of 79,311 Chinese national standards (openstd: mandatory GB / recommended GB/T / guiding GB/Z). **Metadata only, no full text**: code, Chinese and English title, status, issue and effective dates, ICS class, tags.

Base URL `https://api.1stauthor.com`. Every call takes `Authorization: Bearer $FA_API_KEY`; the free samples named below work without a key. Free sample id: `GB/T 42729-2023`, free sample query: `锂离子电池 安全`.

## Three verbs, every domain

```
POST /v1/{domain}/search  {query, filters?, top_k?}      → hits[].id + a card each
GET  /v1/{domain}/read/{id}?level=brief|detail|full      → read as deep as you need
POST /v1/{domain}/ask     {query, effort: low|medium|high} → an answer with real citations
```

`read` also takes `extra=<side>` for another side of the same document and `format=json|md|html`.
At `level=full`, `section=<name>` reads one section and `characters=N` the first N characters.

## Start here

- **Find standards** — `POST /v1/standards/search {"query": "锂离子电池安全", "filters": {"state": "现行"}}`
- **Read one entry** — `GET /v1/standards/read/GB%2FT%2042729-2023`

## Search filters

| field | type | meaning |
|---|---|---|
| `nature` | keyword · eq any | Nature: mandatory / recommended / guiding |
| `state` | keyword · eq any | Status: in force / coming into force / withdrawn / suspended |
| `std_prefix` | keyword · eq any | Code prefix |
| `ics` | keyword · eq any | ICS top-level class (see facets) |
| `is_mandatory` | bool · eq | Mandatory |
| `issue_year` | integer · eq range | Issue year, range |
| `act_year` | integer · eq range | Effective year, range |

Rarely needed, but valid: `tags`.

Filters combine with AND; `_or` / `_not` are available. Ranges are `{"gte": n}` / `{"lte": n}`, full text is `{"text": "…"}`.

## Read

| level | credits | returns |
|---|---|---|
| `brief` | 1 | Card: the fields needed to triage, same as in search hits |
| `detail` (default) | 2 | Every structured field (rule-derived plus model-generated; model fields are listed in _enrich.fields) |
| `full` | 5 | Full text (not available yet: the standard text is not in this corpus — see openstd.samr.gov.cn) |

## Ask

`POST /v1/standards/ask {query, effort}` — Agentic Q&A, with one boundary up front: this domain holds catalogue metadata only, no clause text. It can answer which standards exist, how they are classified, whether they are in force and when they take effect; it cannot answer what a clause says — it will say so and point at openstd. Citations are [standards:<std_code> <title>]. Costs 50 / 100 / 200 credits by effort. Append `/stream` for NDJSON; the first event is always `billing`.

`sources` is the retrieval set, not the citation list — filter it by the ids that appear in `answer`. `answer_truncated` means the answer is incomplete; say so.

## Also here



## Facets

`GET /v1/standards/facets?field=<field>` lists the legal values for `nature`, `state`, `std_prefix`, `ics` — free, no key. Use it instead of guessing a spelling.

## Working rules

- **Search first, read second.** A search hit is a card; decide from the card which ids deserve a read.
- **Read in layers.** `detail` answers most questions; go to `full` only when the answer is not in it.
- **Filters are declared.** An undeclared filter field is a 400, never a silent no-op. `GET /v1/{domain}` lists what exists.
- **Cite what you read.** Use the citation format below, and say plainly when the corpus has nothing.
- **Failures are not charged.** A 404 costs nothing; an upstream error is refunded. Quote `meta.request_id` when reporting one.

Citation format: `[GB/T 42729-2023]`.

## What this corpus will and will not tell you

- Metadata only: the text itself is on openstd (the `fulltext` flag says whether openstd has it online).
- English titles and tags are generated from the Chinese title alone — not authoritative translations.
- 48,406 are in force and 28,535 withdrawn — filter state=现行 before citing.
- The index holds no full text: level=full is not available yet (the standard text is not in this corpus — see openstd.samr.gov.cn).

---

Generated from https://api.1stauthor.com/v1/standards on 2026-10-14. Full reference: https://1stauthor.com/docs/standards/