Endpoints
GET
/api/v1/products
List all products in your account with compliance scores.
| Parameter | Type | Required | Description |
|---|
api_key | string | Yes | Your API key |
Example Response
[
{
"id": 1,
"name": "Organic Cotton T-Shirt",
"sku": "OCT-001",
"compliance_score": 85
},
{
"id": 2,
"name": "Recycled Denim Jacket",
"sku": "RDJ-042",
"compliance_score": 72
}
]
GET
/api/v1/products/{id}
Get full product detail including materials breakdown.
| Parameter | Type | Required | Description |
|---|
id | integer | Yes | Product ID (path parameter) |
api_key | string | Yes | Your API key |
Example Response
{
"id": 1,
"name": "Organic Cotton T-Shirt",
"sku": "OCT-001",
"category": "Textiles",
"compliance_score": 85,
"materials": [
{
"name": "Organic Cotton",
"percentage": 95,
"origin": "India",
"certified": true
},
{
"name": "Elastane",
"percentage": 5,
"origin": "Germany",
"certified": false
}
]
}
GET
/api/v1/products/{id}/passport
Get the structured Digital Product Passport (DPP) data, ready for EU regulatory submission.
| Parameter | Type | Required | Description |
|---|
id | integer | Yes | Product ID (path parameter) |
api_key | string | Yes | Your API key |
Example Response
{
"passport_id": "DPP-2026-001",
"product_name": "Organic Cotton T-Shirt",
"manufacturer": "EcoWear Ltd",
"country_of_origin": "India",
"compliance_score": 85,
"grade": "B+",
"materials": [
{"name": "Organic Cotton", "percentage": 95, "recyclable": true},
{"name": "Elastane", "percentage": 5, "recyclable": false}
],
"sustainability": {
"carbon_footprint_kg": 4.2,
"water_usage_liters": 1200,
"recyclability_score": 78
},
"regulations": [
{"name": "ESPR", "status": "compliant", "details": "Digital Product Passport ready"},
{"name": "CBAM", "status": "review", "details": "Carbon reporting pending"}
],
"generated_at": "2026-04-09T12:00:00Z"
}
GET
/api/v1/compliance/check
Run a real-time compliance audit against EU regulations. Returns a score, grade, and list of flagged issues.
| Parameter | Type | Required | Description |
|---|
api_key | string | Yes | Your API key |
category | string | Yes | Product category (e.g. "textiles", "electronics", "batteries") |
markets | string | Yes | Comma-separated target markets (e.g. "EU,UK") |
origin | string | No | Country of origin (e.g. "CN", "IN", "DE") |
green_claims | string | No | Comma-separated green claims (e.g. "recyclable,carbon-neutral") |
Example Response
{
"compliance_score": 62,
"grade": "C",
"category": "textiles",
"markets": ["EU", "UK"],
"issues": [
{
"regulation": "ESPR",
"severity": "high",
"message": "Digital Product Passport not yet generated"
},
{
"regulation": "Green Claims Directive",
"severity": "medium",
"message": "Claim 'carbon-neutral' requires third-party verification"
},
{
"regulation": "CBAM",
"severity": "low",
"message": "Carbon border adjustment reporting recommended for imports from CN"
}
],
"recommendations": [
"Generate a Digital Product Passport to satisfy ESPR requirements",
"Obtain third-party certification for all green marketing claims",
"Prepare CBAM documentation for EU import declarations"
]
}