# 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): Use this endpoint to send us the Suppliers data needed for the analysis.

Within Fairly Made data model, supplier data covers all the stakeholders involved in your product lifecycle — from manufacturers and fabric mills to agents, wholesalers, and warehouses. This includes any entity that transforms, handles, or stores your materials and products throughout the supply chain.

Each supplier site in our system requires a unique identifier — this can be your internal code or reference for that specific site.

Key rule: If any supplier details differ, create a separate unique_identifier. This is especially important for supplier groups with multiple locations, as each site needs its own reference since operations and capabilities may vary. You have the option to declare the parent company name at site creation.

During the Supplier Data Collection phase (if applicable), suppliers (excluding warehouses) will be contacted to update, modify and enrich their information directly with us, based on the details you have provided.

### Create material *

 - [POST /materials](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1materials/post.md): Optional endpoint. Calling this endpoint is optional. If you use it, 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): Component data covers all the individual elements that make up your products — from main fabrics and linings to hardware like zippers, buttons, outsoles, and uppers. Each component is made of one or multiple raw materials such as cotton, bovine leather, metal, polyamide, etc.

Each component needs a unique identifier representing specific characteristics including composition, usage_category, and supplier (owner or address).

Key rule: If any component characteristics differ, create a separate unique_identifier. You must include either the owner (owner_kind, owner_id) or the processing step address, but not both.

### Create packaging *

 - [POST /packagings](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1packagings/post.md): Optional endpoint. Calling this endpoint is optional.

Packaging data includes all containers, bags, boxes, and wrapping materials that accompany your products and are delivered to the end consumer.

This information is essential for AGEC compliance, the French environmental regulation requiring brands to report on the packaging they place on the market.

For more information about visit the official declaration page.

### Create manufactured product

 - [POST /manufactured-products](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1manufactured-products/post.md): Use this endpoint to create the product that your manufacturer has sold to you. This is different to your own brand product data that you would send us via the 'Add Brand Product Information' endpoint.

### Create purchased item *

 - [POST /purchased-items](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1purchased-items/post.md): Optional endpoint. Calling this endpoint is optional. If you use it, create a record representing an item purchased between buyers and sellers with transport and quantity details.

### Create file *

 - [POST /files](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1files/post.md): Optional endpoint. Calling this endpoint is optional.

Create a file with a unique identifier, name and URL content. Returns file ID.

### Add brand product information

 - [POST /add-brand-product-info](https://doc.api.fairlymade.com/swagger-fairlymadeapi-v3/paths/~1add-brand-product-info/post.md): Add any additional information relating to a specific product analysis. This information is specific to you as a client. When using Fairly Made for tracaebility, sending this information is mandatory.