> ## Documentation Index
> Fetch the complete documentation index at: https://code.dcycle.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List Custom Emission Factors

> Get paginated list of custom emission factors in a group

# List Custom Emission Factors

Retrieve all custom emission factors within a specific Custom Emission Group with pagination support.

## Request

### Headers

<ParamField header="x-api-key" type="string" required>
  Your API key for authentication

  **Example:** `sk_live_1234567890abcdef`
</ParamField>

<ParamField header="x-organization-id" type="string" required>
  Your organization UUID

  **Example:** `ff4adcc7-8172-45fe-9cf1-e90a6de53aa9`
</ParamField>

<ParamField header="x-user-id" type="string" required>
  Your user UUID

  **Example:** `a1b2c3d4-e5f6-7890-abcd-ef1234567890`
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  UUID of the Custom Emission Group
</ParamField>

### Query Parameters

<ParamField query="page" type="integer" default="1">
  Page number
</ParamField>

<ParamField query="size" type="integer" default="50">
  Items per page (max: 100)
</ParamField>

## Response

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "page": 1,
  "size": 50,
  "total": 15,
  "items": [
    {
      "id": "factor-uuid",
      "ef_name": "Recycled Aluminum - Supplier ABC",
      "unit_id": "kg-unit-uuid",
      "factor_uploaded_by": "sustainability@company.com",
      "tag": "advanced",
      "uncertainty_grade": 15.0,
      "factor_start_date": "2024-01-01",
      "factor_end_date": "2024-12-31",
      "additional_docs": "EPD No. ABC-2024-001",
      "emission_factor_values": [
        {"gas_type": "CO2", "value": 2.15},
        {"gas_type": "CH4", "value": 0.008}
      ],
      "recycled": true
    }
  ]
}
```

## Example

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
import requests
import os

headers = {
    "Authorization": f"Bearer {os.getenv('DCYCLE_API_KEY')}",
    "x-organization-id": os.getenv("DCYCLE_ORG_ID"),
    "x-user-id": os.getenv("DCYCLE_USER_ID")
}

group_id = "group-uuid"

response = requests.get(
    f"https://api.dcycle.io/api/v1/custom_emission_factors/list/{group_id}",
    headers=headers,
    params={"page": 1, "size": 50}
)

factors = response.json()
print(f"Total factors: {factors['total']}")

for factor in factors['items']:
    co2_value = next(v['value'] for v in factor['emission_factor_values'] if v['gas_type'] == 'CO2')
    print(f"- {factor['ef_name']}: {co2_value} kg CO2/{factor['unit_id']}")
```

## Related Endpoints

<CardGroup cols={2}>
  <Card title="Create Factor" icon="plus" href="/api-docs/custom-emission-factors/create">
    Add new factor
  </Card>

  <Card title="Get Factor" icon="magnifying-glass" href="/api-docs/custom-emission-factors/get">
    View factor details
  </Card>
</CardGroup>