> For the complete documentation index, see [llms.txt](https://tri.gitbook.io/tri-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tri.gitbook.io/tri-doc/carbon-credit/get-projects-list.md).

# Get Projects List

### Carbon Credit

<mark style="color:blue;">`GET`</mark> <https://sandbox.triangle.digital/api/v2/carbon\\_credit\\_form>

A summary of your projects. Values are published the same way [View Project](/tri-doc/carbon-credit/view-project.md) publishes them — Yes/No answers as words, prices and quantities as numbers — except `asset_category` and `asset_type`, which come back empty in this summary.

**Headers**

<table data-full-width="true"><thead><tr><th>Name</th><th>Value</th></tr></thead><tbody><tr><td>Content-Type</td><td><code>application/json</code></td></tr></tbody></table>

**Query parameters**

<table data-full-width="true" data-search="false"><thead><tr><th width="200">Name</th><th width="110">Type</th><th>Description</th><th width="260">Example</th></tr></thead><tbody><tr><td><code>hash</code></td><td>string</td><td><strong>Required.</strong> API key.</td><td>fk5f0iuy-rr06-j4x3-i75b-fy2s67s4ilo1</td></tr></tbody></table>

**Response fields**

<table data-full-width="true" data-search="false"><thead><tr><th width="300">Field</th><th width="110">Type</th><th>Description</th></tr></thead><tbody><tr><td><code>message</code></td><td>string</td><td>Human-readable result of the call.</td></tr><tr><td><code>success</code></td><td>boolean</td><td>Whether the list was retrieved; a refused call answers HTTP 400.</td></tr><tr><td><code>data.forms[].id</code></td><td>integer</td><td>Row identifier of the project. Address the project by <code>asset_id</code>, not by this value.</td></tr><tr><td><code>data.forms[].asset_id</code></td><td>string</td><td>Identifier of the project. Use it in the URL of <a href="/tri-doc/carbon-credit/view-project.md">View Project</a> and <a href="/tri-doc/carbon-credit/update-project.md">Update Project</a>.</td></tr><tr><td><code>data.forms[].minted</code></td><td>string</td><td><code>Yes</code> once the project's contract has been issued, otherwise <code>No</code>. A minted project can no longer be changed through <a href="/tri-doc/carbon-credit/update-project.md">Update Project</a>, which refuses it with a <code>400</code>. Not to be confused with <code>you_identified_custody_partner_minted</code>, which is a questionnaire answer.</td></tr><tr><td><code>data.forms[].asset_name</code></td><td>string</td><td>Name of the project.</td></tr><tr><td><code>data.forms[].asset_country</code>, <code>asset_city</code>, <code>asset_state</code>, <code>asset_zip</code></td><td>string</td><td>Location of the asset.</td></tr><tr><td><code>data.forms[].asset_category</code>, <code>asset_type</code></td><td>string</td><td>Empty in the summary; the full values are in <a href="/tri-doc/carbon-credit/view-project.md">View Project</a>.</td></tr><tr><td><code>data.forms[].carbon_credit_frequency</code></td><td>string</td><td>One of: <code>Recurring</code>, <code>One-time</code>.</td></tr><tr><td><code>data.forms[].selling_carbon_tons</code></td><td>number</td><td>How many tons the project creates.</td></tr><tr><td><code>data.forms[].selling_carbon_ton_price_no_commission</code></td><td>number</td><td>Expected price per ton.</td></tr><tr><td><code>data.forms[].price_public</code>, <code>qty_public</code></td><td>string</td><td>Whether the price and the QTY are public. One of: <code>Yes</code>, <code>No</code>.</td></tr><tr><td><code>data.forms[].project_available_to_sell</code></td><td>string</td><td>Whether the project is available to sell. One of: <code>Yes</code>, <code>No</code>.</td></tr><tr><td><code>data.forms[].available_to_sell_qty</code></td><td>number</td><td>Available to Sell QTY, in tons. <code>null</code> when not stated.</td></tr><tr><td><code>data.forms[].ex_ante_post</code></td><td>string</td><td>Whether the project is ex-ante or ex-post. One of: <code>Ex-ante</code>, <code>Ex-post</code>, <code>Both</code>. Empty when not answered.</td></tr><tr><td><code>data.forms[].is_when_issued</code>, <code>is_corsia</code>, <code>is_when_verified</code>, <code>is_icvcm_ccp_approved</code></td><td>string</td><td>One of: <code>Yes</code>, <code>No</code>.</td></tr><tr><td><code>data.forms[].name_of_methodology</code></td><td>string</td><td>Name of the linked methodology, read from the methodology itself — the same source <a href="/tri-doc/carbon-credit/view-project.md">View Project</a> uses.</td></tr><tr><td><code>operations_count</code></td><td>integer</td><td>Operations counted for this call in the API usage accounting.</td></tr></tbody></table>

**Response**

{% tabs %}
{% tab title="200" %}
{% code fullWidth="false" %}

```json
{
    "message": "Data received successfully.",
    "success": true,
    "data": {
        "forms": [
            {
                "id": 35251,
                "asset_id": "3BAF973B8A0564F898F1F94B7354C5E7",
                "minted": "No",
                "asset_name": "Mangrove Restoration Phase II",
                "asset_country": "United States",
                "asset_city": "Buckeye",
                "asset_state": "AZ",
                "asset_zip": "85326",
                "asset_category": "",
                "asset_type": "",
                "carbon_credit_frequency": "Recurring",
                "selling_carbon_tons": 360000.0,
                "selling_carbon_ton_price_no_commission": 18.5,
                "price_public": "Yes",
                "qty_public": "No",
                "project_available_to_sell": "Yes",
                "ex_ante_post": "Ex-post",
                "is_when_issued": "No",
                "is_corsia": "No",
                "name_of_methodology": "Blue Carbon Protocol"
            }
        ]
    },
    "operations_count": 1
}
```

{% endcode %}
{% endtab %}

{% tab title="400" %}
This answer means the `hash` did not match any account; nothing is read.

```json
{
    "message": "Error! No such hash.",
    "success": false
}
```

{% endtab %}
{% endtabs %}