# Status embed installed correctly

This will be shown if an incident or maintenance is posted on your status page.

# Search generated fuel mix

get

https://api.singularity.energy/v2/generated/fuel-mix

Search generated fuel mix events in a region.

## [Request](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#Request)

Security: API Key

### [Query Parameters](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#Query-Parameters)

- **page**  
  integer  
  The page of data to return.  
  >= 1  
  Default: 1  
  Example: 5

- **resolution**  
  string  
  The desired time resolution.  
  Allowed values: 5m1h  
  Default: 5m  
  Example: 5m

- **end**  
  string<date-time>  
  required  
  A datetime in ISO-8601 format.  
  Default: 2022-01-03T00:00:00Z  
  Example: 2022-01-07T00:00:00Z

- **region**  
  string  
  required  
  The region to fetch data from.  
  Default: ISONE  
  Example: ISONE

- **source**  
  string  
  required  
  The source to retrieve data from. There may be multiple sources for the same region.  
  Allowed values: ISOEIAISO-H  
  Default: EIA  
  Example: ISO

- **start**  
  string<date-time>  
  required  
  A datetime in ISO-8601 format.  
  Default: 2022-01-02T00:00:00Z  
  Example: 2022-01-02T03:00:00+00:00

- **per_page**  
  integer  
  The number of results to include in a paginated response.  
  >= 1<= 500  
  Default: 300  
  Example: 20

- **raw**  
  boolean  
  Return the raw data that we scraped from its original source.  
  Default: false  
  Example: false

### [Headers](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#request-headers)

- **x-api-key**  
  string  
  required  
  Your Singularity API key, which can be found by signing into Carbonara.  
  Default: MY_API_KEY

## [Responses](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#Responses)

### 200  
   
### 400  
   
### 500  
   
OK

### [Headers](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#response-headers)

- **singularity-request-id**  
  string

### [Body](https://docs.singularity.energy/docs/singularity-api/grid-carbon-api/operations/get-a-generated-fuel-mix#response-body)

application/json

Auth

X-API-Key:

Parameters

- **end***:
- **region***:
- **source***:
  ISOEIAISO-H
  EIA
- **start***:
- **page:**
- **per_page:**
- **raw:**
  Not SetFalseTrue
  select an option (defaults to: false)
- **resolution:**
  Not Set5m1h
  select an option (defaults to: 5m)

Send API Request

Live Server

Request Sample: Shell / cURL

```bash
curl --request GET \
  --url 'https://api.singularity.energy/v2/generated/fuel-mix?region=ISONE&source=EIA&start=2022-01-02T00%3A00%3A00Z&end=2022-01-03T00%3A00%3A00Z' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: 123' \
  --header 'x-api-key: '
```

Response Example

```json
{
  "data": [
    {
      "data": {
        "coal_mw": 5999,
        "hydro_mw": 14,
        "natural_gas_mw": 12813,
        "nuclear_mw": 5126,
        "other_mw": 134,
        "solar_mw": 0,
        "wind_mw": 17780
      },
      "dedup_key": "generated_fuel_mix:ERCO:2023-01-01T00:00:00+00:00",
      "event_type": "generated_fuel_mix",
      "meta": {
        "data_source": "EIA",
        "inserted_at": "2023-01-01T12:07:24.426265Z",
        "raw_start_date": "2023-01-01T01:00:00+00:00",
        "scraped_at": "2023-01-19T19:11:19.469707",
        "source": "ERCO:raw.generated_fuel_mix:2023-01-01T01:00:00+00:00",
        "updated_at": "2023-01-19T23:04:45.628929Z",
        "warnings": []
      },
      "region": "ERCOT",
      "start_date": "2023-01-01T00:00:00+00:00"
    },
    // Additional data...
  ],
  "meta": {
    "pagination": {
      "first": 1,
      "last": 1,
      "this": 1
    }
  }
}
```
