---
title: "Supplier Projects"
method: GET
path: "/suppliers/{id}/projects"
---

# Supplier Projects

`GET /suppliers/{id}/projects`

List of projects for a given supplier.

Projects are sorted by most recently created first.

## Path parameters

- `id` string, required

## Query parameters

- `last` integer — An integer number of items to retrieve before the item represented by the cursor passed in the before parameter. Defaults to 10 with a maximum value of 50.
- `before` string, nullable — An opaque cursor representing the first item in the previously requested page to select items ordered before it. Submit the previously requested page’s start_cursor here when paginated backwards.
- `first` integer — An integer number of items to retrieve after the item represented by the cursor passed in the after parameter. Defaults to 10 with a maximum value of 50.
- `after` string, nullable — An opaque cursor representing the last item in the previously requested page to select items ordered after it. Submit the previously requested page’s end_cursor here when paginated forwards.

## Headers

- `x-client-secret` string, required — A secret token identifying the client connecting to the API

## Response `200`

Successful Response

- PaginatedListResourceProject
  - `nodes` Project[], required
    - `id` string, required
    - `name` string, required
    - `supplier` Supplier, required
      - `id` string, required
      - `short_description` string, nullable, required
      - `long_description` string, nullable, required
      - `organisation` Organisation, required
        - `id` string, required
        - `name` string, required
        - `domain` string, nullable, required
      - `location` Location, required
        - `country_code` string, required — An ISO 3166-1 alpha-3 country code
        - `country_name` string, required
        - `latitude` number, required — A WGS84 latitude in decimal degrees, between -90 and 90.
        - `longitude` number, required — A WGS84 longitude in decimal degrees, between -180 and 180.
        - `description` string, nullable
    - `status` 'draft' | 'preview' | 'under_validation' | 'validated' | 'validation_unsuccessful' | 'cancelled', required
    - `short_code` string, required — A random short code, uniquely identifying the project
    - `url` string, required — The url to the Isometric page for this project
    - `pathway` 'biomass_carbon_removal_and_storage' | 'biosphere' | 'direct_air_capture' | 'enhanced_weathering' | 'carbon_mineralization' | 'marine' | 'superpollutants' | 'environmental_attribute_certificates', required
    - `durability` 'permanent' | 'over_one_thousand_years' | 'over_two_hundred_years' | 'over_one_hundred_years' | 'over_eighty_years' | 'over_sixty_years' | 'over_forty_years', required — Durability of carbon removal performed by the project, which is a function of the selected protocol and possibly some relevant project protocol settings.
    - `protocol_slug` string, required — A protocol's URL-friendly identifier: lowercase alphanumeric groups separated by single hyphens
    - `protocol_data` ProjectProtocolData, required
      - `slug` string, required — A protocol's URL-friendly identifier: lowercase alphanumeric groups separated by single hyphens
      - `name` string, required — The name of the protocol this project is following
      - `baseline_version` string, nullable, required — A minor version string in the format X.Y (e.g., '1.0', '2.5')
      - `current_version` string, nullable, required — A minor version string in the format X.Y (e.g., '1.0', '2.5')
    - `country_code` string, required — An ISO 3166-1 alpha-3 country code
    - `validator_name` string, nullable, required — The name of the organization responsible for validating this project, if assigned
    - `current_verifier_name` string, nullable, required — The name of the organization currently responsible for verifying this project, if assigned
    - `crediting_period_start` string, date, nullable, required
    - `crediting_period_end` string, date, nullable, required
    - `issued_credits_total` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `retired_credits_total` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `issued_buffer_pool_credits_total` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `retired_buffer_pool_credits_total` CreditQuantity, required
      - `credits` number, required — A representation of the credit quantity as a fractional amount, to 3 decimal places. Where 1 unit represents 1 credit and 1 ton of CO₂e.
      - `credit_kgs` integer, required — A representation of the credit quantity as an integer kilogram amount. Where 1 unit represents 0.001 credits and 1 kilogram of CO₂e. This field can handle bigint values.
    - `location` Location, required
      - `country_code` string, required — An ISO 3166-1 alpha-3 country code
      - `country_name` string, required
      - `latitude` number, required — A WGS84 latitude in decimal degrees, between -90 and 90.
      - `longitude` number, required — A WGS84 longitude in decimal degrees, between -180 and 180.
      - `description` string, nullable
  - `total_count` integer, required
  - `page_info` PageInfo, required
    - `has_previous_page` boolean, required
    - `start_cursor` string, nullable, required
    - `has_next_page` boolean, required
    - `end_cursor` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/isometric/apis/isometric-registry-api.md) · [All operations](https://skmtc.net/isometric/apis/isometric-registry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/isometric/isometric-registry-api/versions/2e31eeb1cb99/schema)