Retrieve a material property

Fetch a single property of a material. Useful when you only need one numeric row (e.g. carbon content) and don't want to pull the whole material payload.

GET/public/materials/:id/properties/:propertyId

Companion to GET /public/materials/:id — same masking, but returns only the named property instead of the full material payload. If the property doesn't belong to the given material, you get a clean 404Not Found instead of silently returning a property from a different material.

Path parameters

Parameter	Type	Description
idrequired	string (uuid)	The material id.
propertyIdrequired	string (uuid)	The id of the property row to retrieve.

Response

200OK

{
  "id": "55ada0c0-1234-4d1e-9b21-3a8e2c91c0a1",
  "name": "carbon content",
  "value": 0.857,
  "unit": "kg",
  "description": "Mass fraction of elemental carbon per kg of material.",
  "source": "Ecoinvent 3.10",
  "sourceOrganization": "ecoinvent",
  "datePublished": "2024-09-01",
  "revealed": true,
  "deleted": false,
  "revealType": "pulled"
}

If revealed is false, every sensitive numeric field (value, mean, standardDeviation, …) is masked to null. Purchase access via POST /materials/:id/properties/pull.

Errors

404Not Foundwhen the material doesn't exist, the property doesn't exist on this material, or either record is soft-deleted.

Example

curl -s 'https://api.circa.ai/public/materials/8c2a…/properties/55ada…' \
  -H 'x-api-key: circa_live_xxx' \
  -H 'x-team-id: TEAM_ID_FROM_OVERVIEW' \
  -H 'Circa-Version: 2026-05-11.arrakis'