Skip to content

Reference Data API

The Reference Data API provides lookup endpoints for NACE industry codes and country data used throughout the Carbon Connect platform. These are static reference datasets used for grant eligibility filtering and company profile configuration.

All endpoints are public and do not require authentication.

Endpoints

GET /reference/nace-codes

Search and list NACE (Nomenclature of Economic Activities) codes. NACE Rev. 2 is the European standard for classifying economic activities and is used by the matching engine for industry-based grant eligibility.

Authentication: Not required

[
  {
    "code": "D35",
    "description": "Electricity, gas, steam and air conditioning supply",
    "section": "D",
    "division": "35",
    "group": null,
    "class": null
  },
  {
    "code": "M71",
    "description": "Architectural and engineering activities; technical testing",
    "section": "M",
    "division": "71",
    "group": null,
    "class": null
  }
]

curl -X GET "https://api.carbonconnect.io/api/v1/reference/nace-codes?query=energy&limit=10"

curl -X GET "https://api.carbonconnect.io/api/v1/reference/nace-codes?section=C&limit=20"

Query Parameters:

Parameter Type Default Description
query string -- Search term (matches code or description, min 1 char)
section string -- Filter by NACE section letter (A-S)
limit integer 50 Maximum results (1-100)

Response Body (array of NaceCodeResponse):

Field Type Description
code string NACE code (e.g., A01, C25, D35)
description string Human-readable description
section string NACE section letter (A-S)
division string NACE division (2-digit)
group string NACE group (3-digit, if applicable)
class string NACE class (4-digit, if applicable)

Available NACE Sections

Section Description
A Agriculture, forestry and fishing
B Mining and quarrying
C Manufacturing
D Electricity, gas, steam and air conditioning supply
E Water supply; sewerage, waste management and remediation
F Construction
G Wholesale and retail trade; repair of motor vehicles
H Transportation and storage
I Accommodation and food service activities
J Information and communication
K Financial and insurance activities
L Real estate activities
M Professional, scientific and technical activities
N Administrative and support service activities
O Public administration and defence
P Education
Q Human health and social work activities
R Arts, entertainment and recreation
S Other service activities

Common Codes for Carbon Grants

The following NACE codes are frequently relevant for carbon/sustainability grants:

  • D35 -- Electricity, gas, steam and air conditioning supply
  • E38 -- Waste collection, treatment and disposal activities
  • F41-F43 -- Construction (green buildings)
  • C20 -- Manufacture of chemicals and chemical products
  • M71 -- Architectural and engineering activities
  • M72 -- Scientific research and development
  • H49 -- Land transport and transport via pipelines

Status Codes:

Code Description
200 NACE codes returned

GET /reference/countries

List countries eligible for EU grant programs. Includes EU member states (27), EEA members, and commonly associated countries.

Authentication: Not required

[
  {
    "code": "DE",
    "name": "Germany",
    "flag_emoji": "\ud83c\udde9\ud83c\uddea",
    "is_eu_member": true,
    "is_eea_member": true
  },
  {
    "code": "GB",
    "name": "United Kingdom",
    "flag_emoji": "\ud83c\uddec\ud83c\udde7",
    "is_eu_member": false,
    "is_eea_member": false
  }
]

curl -X GET "https://api.carbonconnect.io/api/v1/reference/countries?eu_only=true"

curl -X GET "https://api.carbonconnect.io/api/v1/reference/countries?query=germ"

Query Parameters:

Parameter Type Default Description
eu_only boolean false Only return EU member states (27 countries)
eea_only boolean false Only return EEA members (EU + IS, LI, NO)
query string -- Search by country name or ISO code (min 1 char)

Filter Priority

If both eu_only and eea_only are set to true, eu_only takes precedence.

Response Body (array of CountryResponse):

Field Type Description
code string ISO 3166-1 alpha-2 country code
name string Country name in English
flag_emoji string Flag emoji character
is_eu_member boolean Whether the country is an EU member state
is_eea_member boolean Whether the country is an EEA member

Country Categories

Category Count Examples
EU Member States 27 DE, FR, IT, ES, PL, NL
EEA (non-EU) 3 IS, LI, NO
Associated Countries 7 CH, GB, UA, MD, GE, IL, TR
Candidate / Potential 6 AL, ME, MK, RS, BA, XK

Status Codes:

Code Description
200 Countries returned