Skip to main content

Get a list of Consumptions

Get a list of Consumptions

Query Parameters
per_page number

Define the number of items per page, default is 100

page number

Define the page number, default is 1

term string

Search term

month string

Filter by month (1-12)

year string

Filter by year

cnpj string

Filter by national registry number (CNPJ)

fuel string

Filter by fuel type

category string

Filter by category

Responses
200

200 response

Schema OPTIONAL
object[]
id string OPTIONAL

The unique identifier of the comsumption

national_registry_number string OPTIONAL

The National Registry Number of the company associated with the consumption

month integer OPTIONAL

A number between 1 and 12 representing the month of the consumption

year integer OPTIONAL

A number representing the year of the consumption

category string OPTIONAL

Possible values: [ENERGY, MOBILE_COMBUSTION, STATIONARY_COMBUSTION]

The GHG protocol category related with the consumption

source_description string OPTIONAL

The description of the source of the consumption

fuel string OPTIONAL

Possible values: [ACETYLENE, TAR, ASPHALTS, SUGARCANE_BAGASSE, BIODIESEL_B100, BIOGAS, SUGARCANE_JUICE, IMPORTED_METALLURGICAL_COAL, NATIONAL_METALLURGICAL_COAL, STEAM_COAL_3100_KCAL_KG, STEAM_COAL_3300_KCAL_KG, STEAM_COAL_3700_KCAL_KG, STEAM_COAL_4200_KCAL_KG, STEAM_COAL_4500_KCAL_KG, STEAM_COAL_4700_KCAL_KG, STEAM_COAL_5200_KCAL_KG, STEAM_COAL_5900_KCAL_KG, STEAM_COAL_6000_KCAL_KG, UNSPECIFIED_STEAM_COAL, CHARCOAL, MINERAL_COAL_COKE, PETROLEUM_COKE, ETHANE, ETHANOL, COKE_OVEN_GAS, REFINERY_GAS, LPG, DRY_NATURAL_GAS, WET_NATURAL_GAS, COMMERCIAL_AUTOMOTIVE_GASOLINE, PURE_AUTOMOTIVE_GASOLINE, AVIATION_GASOLINE, FIREWOOD_FOR_CHARCOAL, COMMERCIAL_FIREWOOD, BLACK_LIQUOR, NGL, LUBRICANTS, MOLASSES, NAPHTHA, FUEL_OIL, SHALE_OIL, COMMERCIAL_DIESEL_OIL, PURE_DIESEL_OIL, RESIDUAL_OILS, OTHER_PETROLEUM_PRODUCTS, PARAFFIN_WAX, CRUDE_OIL, AVIATION_KEROSENE, ILLUMINATING_KEROSENE, INDUSTRIAL_WASTE, MUNICIPAL_WASTE_BIOMASS_FRACTION, MUNICIPAL_WASTE_NON_BIOMASS_FRACTION, VEGETABLE_RESIDUES, SOLVENTS, PEAT, OIL_SHALE_AND_TAR_SANDS, CNG, COAL, PURE_MARINE_DIESEL_OIL, OTHER_BIOGAS, LANDFILL_GAS, BIOMETHANE, LNG, METHANOL, BIOKEROSENE_SAF, HVO_GREEN_DIESEL, BIOMETHANOL]

The fuel related with the consumption (only to MOBILE_COMBUSTION and STATIONARY_COMBUSTION categories)

quantity number OPTIONAL

The quantity of the consumption

unit_measure string OPTIONAL

Possible values: [T, KG, MG, L, M3, ML, KWH, MWH]

The unit of measure related with the consumption