# Fairly Made API

The Fairly Made API describes endpoints for creating and retrieving supply‑chain entities such as suppliers, materials, components, products and purchased items.  


Version: 3.0.0

## Servers

```
https://api.fairlymade.com
```

## Download OpenAPI description

[Fairly Made API](https://doc.api.fairlymade.com/_bundle/swagger-FairlyMadeAPI-v3.yaml)

## Other

### Create supplier

 - [POST /suppliers](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1suppliers/post.md): Create a new supplier record with site information and optional certifications.

### Create material

 - [POST /materials](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1materials/post.md): Create a raw material and optionally define processing steps; you must include either the owner (owner_kind, owner_id) or the processing step address, but not both.

### Create component

 - [POST /components](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1components/post.md): Create a component with composition, optional ownership/address, optional category_family, steps, purchased items, used components and materials. Returns component ID. You must include either the owner (owner_kind, owner_id) or the processing step address, but not both.

### Create manufactured product

 - [POST /products](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1products/post.md): Products aggregate materials, components and packaging with weight, quantity and usage details. You must include either the owner (owner_kind, owner_id) or the processing step address, but not both.

### Create purchased item

 - [POST /purchased-items](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1purchased-items/post.md): Create a record representing an item purchased between buyers and sellers with transport and quantity details.

### Add customer product information

 - [POST /generic-product-infos](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1generic-product-infos/post.md): Add additional generic information for a product or purchased item, such as packaging, naming, pricing and QR code association. This endpoint allows linking packaging and warehouse details to an existing product or purchased item.