Materials List Grades
materials_list_gradesRead-onlyIdempotent
List the material grades available to you.
That is the standards catalogue plus any grade your organization has registered for itself.
q searches across primary_code, display_code, name,
urn AND every alias's code/display_code. A user typing
"AISI 304", "SUS304" or "S30400" therefore finds 1.4301 from this
single endpoint — no need to fall back to POST /lookup.
Returns the total matching row count (not page size) so the frontend can paginate properly.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search across grade codes, names, URNs, and aliases. | |
| limit | No | Maximum rows to return in one page. | |
| cursor | No | Opaque position token from the previous page's `next_cursor` (or the `Link` / `X-Next-Cursor` response header). Omit it for the first page. Keep every other query parameter identical for the whole walk — a cursor replayed against different filters is rejected. | |
| offset | No | Rows to skip. Superseded by `cursor`, which is stable under concurrent writes; kept for existing integrations. Bounded — past the cap, page with `cursor`. | |
| category | No | Filter by material category (e.g. stainless_steel, aluminium). | |
| iso_group | No | Filter by ISO 513 machining group (P, M, K, N, S, H). | |
| include_inactive | No | Include grades your organization has deactivated. They stay out of the list by default; set this to find one again and reactivate it. |