# Altruistiq Export API

**Canonical:** https://apis.io/apis/altruistiq/altruistiq-export-api/  
**Provider:** Altruistiq — https://apis.io/providers/altruistiq/  
**Base URL:** https://app.altruistiq.com/api/public/v1  
**Documentation:** https://docs.altruistiq.com

Altruistiq Export API is one of 9 APIs that [Altruistiq](https://apis.io/providers/altruistiq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Export. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a JSON-LD context, and 4 JSON Schemas.

### Altruistiq’s Export API enables you to: - Export corporate data Exporting data is a key part of the Altruistiq platform. It allows you to take your data and use it in other systems, or to share it with other stakeholders. Currently, our Export API allows you to export your Corporate Emissions data available in Altruistiq, down to a daily grain. We are working hard to also add Product Emissions data to your Export API. If you need to share Product emissions data today, see the PACT API. Schema of files which can be retrieved via this API (data dictionary):<br/> <table> <tbody><tr><th>Column</th><th>Data Type</th><th>Format</th><th>Optional</th><th>Description</th></tr> <tr> <td>fact_uuid</td> <td>string</td> <td>uuid</td> <td>no</td> <td>Unique identifier for emission record.</td> </tr> <tr> <td>calendar_date</td> <td>string</td> <td>date</td> <td>no</td> <td>Date of the emission record.</td> </tr> <tr> <td>calendar_year</td> <td>integer</td> <td></td> <td>no</td> <td>Year of the emission record.</td> </tr> <tr> <td>emission_quantity</td> <td>number | string</td> <td>decimal(28, 10)</td> <td>no</td> <td>Quantity of the emission record.</td> </tr> <tr> <td>emission_unit</td> <td>string</td> <td></td> <td>no</td> <td>Unit the emissions are in.</td> </tr> <tr> <td>calculation_input_quantity</td> <td>number | string | null</td> <td>decimal(28, 10)</td> <td>yes</td> <td>Input quantity used for the actual emission calculation (if applicable).</td> </tr> <tr> <td>calculation_input_quantity_unit</td> <td>string | null</td> <td></td> <td>yes</td> <td>Unit of the input quantity used for the actual emission calculation(if applicable).</td> </tr> <tr> <td>spend_usd</td> <td>number | string | null</td> <td>decimal(28, 10)</td> <td>yes</td> <td>Spend in USD used for the actual emission calculation (if applicable).</td> </tr> <tr> <td>spend_eur</td> <td>number | string | null</td> <td>decimal(28, 10)</td> <td>yes</td> <td>Spend in EUR used for the actual emission calculation (if applicable).</td> </tr> <tr> <td>spend_gbp</td> <td>number | string | null</td> <td>decimal(28, 10)</td> <td>yes</td> <td>Spend in EUR used for the actual emission calculation (if applicable).</td> </tr> <tr> <td>per_unit</td> <td>string</td> <td></td> <td>no</td> <td>Emission Factor divisor.</td> </tr> <tr> <td>input_dimensionality</td> <td>string</td> <td></td> <td>no</td> <td>Dimensionality of the input quantity for the emission factor.</td> </tr> <tr> <td>scope_category</td> <td>string</td> <td></td> <td>no</td> <td>Scope categories are a subdivision of GHG Scopes with more detail about the emission’s cause. Scope categories are similar to, and overlapping with Activities.</td> </tr> <tr> <td>scope</td> <td>string</td> <td></td> <td>no</td> <td>Refers to the three scopes of the GHG Protocol.</td> </tr> <tr> <td>activity_area_name</td> <td>string</td> <td></td> <td>no</td> <td>Activity areas are groups of activities that have similar emissions calculation methodologies in the Altruistiq platform.</td> </tr> <tr> <td>activity_name</td> <td>string</td> <td></td> <td>no</td> <td>Activities areas are activities of a customer causing emissions.</td> </tr> <tr> <td>sub_activity_name</td> <td>string</td> <td></td> <td>no</td> <td>Sub-Activities areas are a sub-dicision activities of a customer causing emissions.</td> </tr> <tr> <td>aq_calc_method</td> <td>string</td> <td></td> <td>no</td> <td>Calculation Methodology used in the Altruistiq platform.</td> </tr> <tr> <td>ghg_calc_method</td> <td>string</td> <td></td> <td>no</td> <td>Calculation Methodology according to the GHG protocol.</td> </tr> <tr> <td>ef_specificity</td> <td>string</td> <td></td> <td>no</td> <td>Specificity level that Emission Factors refer to, e.g. Global Average or Country Average.</td> </tr> <tr> <td>accuracy_score</td> <td>integer</td> <td></td> <td>no</td> <td>A measure of how accurate emissions calculations are for a particular activity, based on the quality of data available and the calculation methodology applied as a result.</td> </tr> <tr> <td>accuracy_score_name</td> <td>string</td> <td></td> <td>no</td> <td>A measure of how accurate emissions calculations are for a particular activity, based on the quality of data available and the calculation methodology applied as a result.</td> </tr> <tr> <td>lifecycle</td> <td>string</td> <td></td> <td>no</td> <td>Emissions caused by an activity can be further subdivided by the lifecycle they are associated with. For example, a business trip in a company car will cause emissions from vehicle use (i.e. burning the fuel) and well-to-tank emissions (i.e. drilling for oil, fuel production, and any other activities in the supply chain).</td> </tr> <tr> <td>bu_uuid</td> <td>string</td> <td>uuid</td> <td>no</td> <td>Unique identifier for a BU.</td> </tr> <tr> <td>bu_name</td> <td>string</td> <td></td> <td>no</td> <td>Name of the BU this record belongs to.</td> </tr> <tr> <td>root_org_uuid</td> <td>string</td> <td>uuid</td> <td>no</td> <td>Unique identifier of the root organisation.</td> </tr> <tr> <td>root_org_name</td> <td>string</td> <td></td> <td>no</td> <td>Name of the root organisation this record belongs to.</td> </tr> <tr> <td>facility_name</td> <td>string | null</td> <td></td> <td>yes</td> <td>Name of the facility this record belongs to (if it is assigned at facility level).</td> </tr> <tr> <td>facility_uuid</td> <td>string | null</td> <td></td> <td>yes</td> <td>Unique identifier of the facility.</td> </tr> <tr> <td>facility_country_name</td> <td>string | null</td> <td></td> <td>yes</td> <td>Country this facility belongs to.</td> </tr> <tr> <td>facility_country_code</td> <td>string | null</td> <td></td> <td>yes</td> <td>Country code of the country this facility belongs to.</td> </tr> <tr> <td>facility_post_code</td> <td>string | null</td> <td></td> <td>yes</td> <td>Post code of this facility.</td> </tr> <tr> <td>facility_type</td> <td>string | null</td> <td></td> <td>yes</td> <td>Type of this facility.</td> </tr> <tr> <td>facility_capacity_ratio</td> <td>number | string | null</td> <td>decimal(28, 10)</td> <td>yes</td> <td>Capacity of this facility.</td> </tr> <tr> <td>data_source_name</td> <td>string</td> <td></td> <td>yes</td> <td>Name of the datasource which was used for this record.</td> </tr> <tr> <td>file_name</td> <td>string</td> <td></td> <td>no</td> <td>Name of the file which was used for this record.</td> </tr> <tr> <td>supplier_legal_name</td> <td>string | null</td> <td></td> <td>yes</td> <td>Supplier legal name (if applicable).</td> </tr> <tr> <td>supplier_country_code</td> <td>string | null</td> <td></td> <td>yes</td> <td>Supplier country code (if applicable).</td> </tr> <tr> <td>supplier_country_name</td> <td>string | null</td> <td></td> <td>yes</td> <td>Supplier country name (if applicable).</td> </tr> <tr> <td>supplier_vat_number</td> <td>string | null</td> <td></td> <td>yes</td> <td>Supplier VAT number (if applicable).</td> </tr> <tr> <td>tags</td> <td>object</td> <td></td> <td>no</td> <td>Mapping of tag category -&gt; value (e.g. energy_type -&gt; mixed). <p><b>PREVIEW WARNING: THESE ARE CURRENTLY BEING CHANGED, SO ARE NOT STABLE!</b></p> <p>Categories:</p> <ul> <li>energy_type</li> <li>fuel_type</li> <li>fuel_net_or_gross_cv</li> <li>gas_type</li> <li>isic_section</li> <li>isic_division</li> <li>isic_group</li> <li>isic_class</li> <li>goods_service_type</li> <li>material_life_phase</li> <li>heating_type</li> <li>industry_type</li> <li>purchased_energy_type</li> <li>refrigerant_type</li> <li>renewable</li> <li>vehicle_type</li> <li>journey_type</li> <li>energy_generation_type</li> <li>vehicle_emission_type</li> <li>traffic_scenario</li> <li>vehicle_load</li> <li>waste_category</li> <li>wastewater_spend_type</li> <li>waste_treatment_type</li> <li>waste_type</li> <li>water_spend_type</li> </ul></td> </tr> <tr> <td>financial_year</td> <td>integer</td> <td></td> <td>no</td> <td></td> </tr> <tr> <td>custom_analytics_fields</td> <td>object</td> <td></td> <td>no</td> <td>Custom Analytics Fields.</td> </tr> <tr> <td>custom_tags</td> <td>object</td> <td></td> <td>no</td> <td>Fields used to tag/classify the record.</td> </tr> <tr> <td>emission_factor_name</td> <td>string | null</td> <td></td> <td>no</td> <td>Name of the emission factor used for this record.</td> </tr> <tr> <td>emission_factor_specificity</td> <td>string | null</td> <td></td> <td>no</td> <td>Specificity of the emission factor used for this record.</td> </tr> <tr> <td>emission_factor_specificity_code</td> <td>string | null</td> <td></td> <td>no</td> <td>Specificity Code of the emission factor used for this record.</td> </tr> <tr> <td>emission_factor_source</td> <td>string | null</td> <td></td> <td>no</td> <td>Source of the emission factor used for this record.</td> </tr> <tr> <td>emission_factor_source_version</td> <td>string | null</td> <td></td> <td>no</td> <td>Source version of the emission factor used for this record.</td> </tr> <tr> <td>created_at</td> <td>string</td> <td>date-time</td> <td>no</td> <td>Timestamp when the record was created. NOTE: this might change if we do a full refresh in the backend.</td> </tr> <tr> <td>updated_at</td> <td>string</td> <td>date-time</td> <td>no</td> <td>Timestamp when the record was updated. NOTE: this might change if we do a full refresh in the backend.</td> </tr> </tbody></table>

## Machine-readable artifacts (15)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/openapi/altruistiq-export-api-openapi.yml
- **Documentation** — https://docs.altruistiq.com
- **Authentication** — https://docs.altruistiq.com
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/json-schema/altruistiq-product-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/json-schema/altruistiq-facility-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/json-schema/altruistiq-emission-record-schema.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/json-structure/altruistiq-product-structure.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/json-ld/altruistiq-context.jsonld
- **SpectralRuleset** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/rules/altruistiq-rules.yml
- **Vocabulary** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/vocabulary/altruistiq-vocabulary.yml
- **Examples** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/examples/altruistiq-oauth-token-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/examples/altruistiq-create-product-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/examples/altruistiq-create-export-example.json
- **Examples** — https://raw.githubusercontent.com/api-evangelist/altruistiq/refs/heads/main/examples/altruistiq-get-export-example.json
- **Standards** — https://www.carbon-transparency.org

## Other Altruistiq APIs (8)

- [Altruistiq Datasource API](https://apis.io/apis/altruistiq/altruistiq-datasource-api/)
- [Altruistiq Facility API](https://apis.io/apis/altruistiq/altruistiq-facility-api/)
- [Altruistiq Location API](https://apis.io/apis/altruistiq/altruistiq-location-api/)
- [Altruistiq Organization API](https://apis.io/apis/altruistiq/altruistiq-organization-api/)
- [Altruistiq Product API](https://apis.io/apis/altruistiq/altruistiq-product-api/)
- [Altruistiq Product structure API](https://apis.io/apis/altruistiq/altruistiq-product-structure-api/)
- [Altruistiq Product structure inputs API](https://apis.io/apis/altruistiq/altruistiq-product-structure-inputs-api/)
- [Altruistiq Security API](https://apis.io/apis/altruistiq/altruistiq-security-api/)

## Tags

Export

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/altruistiq/altruistiq-export-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/altruistiq/.