API Documentation

Access material data programmatically via our REST API.

Quick Start

The MaterialRegistry API is free to use and requires no authentication for public endpoints.

curl "https://api.materialregistry.com/api/v1/materials?q=304"

Base URL

https://api.materialregistry.com

Endpoints

GET /api/v1/materials

Search materials

Parameters

Name	Type	Description
q	string	Search query (e.g., "304", "1.4301")
category	string	Filter by category
limit	number	Results per page (default: 20)
offset	number	Pagination offset

Example

curl "https://api.materialregistry.com/api/v1/materials?q=304"

GET /api/v1/materials/:slug

Get material by slug

Example

curl "https://api.materialregistry.com/api/v1/materials/stainless-steel-304"

GET /api/v1/materials/:slug/equivalents

Get standard equivalents for a material

Example

curl "https://api.materialregistry.com/api/v1/materials/stainless-steel-304/equivalents"

GET /api/v1/search/suggest

Get search suggestions (autocomplete)

Parameters

Name	Type	Description
q	string	Search query (min 2 characters)
limit	number	Max suggestions (default: 10)

Example

curl "https://api.materialregistry.com/api/v1/search/suggest?q=304"

GET /api/v1/categories

List all material categories

Example

curl "https://api.materialregistry.com/api/v1/categories"

GET /api/v1/standards

List all supported standards

Example

curl "https://api.materialregistry.com/api/v1/standards"

Response Format

All responses are returned as JSON with the following structure:

// Success
{
  "success": true,
  "data": { ... }
}

// Error
{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message"
  }
}

Rate Limits

The public API is rate-limited to 100 requests per minute per IP address. If you need higher limits for your application, please contact us.