Project distribution by credit totals

curl --request GET \
  --url https://vcm-fyi-api.fly.dev/v1/charts/projects_by_credit_totals \
  --header 'X-API-KEY: <api-key>'

{
  "pagination": {
    "total_entries": 123,
    "current_page": 123,
    "total_pages": 123,
    "next_page": "<string>"
  },
  "data": [
    {
      "start": 123,
      "end": 123,
      "category": "<string>",
      "value": 123
    }
  ]
}

Charts

Project distribution by credit totals

Get a histogram of projects binned by their total issued or retired credit quantity.

Returns binned data showing how many projects fall into each credit-volume range, broken down by category. Useful for understanding the distribution of project sizes.

Parameters:

credit_type: issued or retired — which total to bin by. Default: issued.
bin_width: Optional custom bin width. If omitted, bins are auto-calculated based on the data range.

Filters: All standard project filters apply.

GET

charts

projects_by_credit_totals

Project distribution by credit totals

curl --request GET \
  --url https://vcm-fyi-api.fly.dev/v1/charts/projects_by_credit_totals \
  --header 'X-API-KEY: <api-key>'

{
  "pagination": {
    "total_entries": 123,
    "current_page": 123,
    "total_pages": 123,
    "next_page": "<string>"
  },
  "data": [
    {
      "start": 123,
      "end": 123,
      "category": "<string>",
      "value": 123
    }
  ]
}

Authorizations

X-API-KEY

string

header

required

Query Parameters

credit_type

enum<string>

default:issued

Credit type

Available options:

issued,

retired

string | null

Case insensitive search string. Currently searches on project_id and name fields only.

bin_width

integer | null

Bin width

current_page

integer

default:1

Page number

Required range: x >= 1

per_page

integer

default:100

Items per page

Required range: 1 <= x <= 200

registry

enum<string>[] | null

Registry name

Available options:

verra,

gold-standard,

american-carbon-registry,

climate-action-reserve,

art-trees,

isometric,

puro-earth,

plan-vivo,

none

country

string[] | null

Country name

protocol

string[] | null

Protocol name

Response

Histogram bins of project counts by credit volume range and category

pagination

Pagination · object

required

Show child attributes

data

ProjectBinnedCreditsTotals · object

required

ProjectBinnedCreditsTotals · object[]
Data · object[]

Show child attributes

Retirements by vintage year for a project Project counts by category

⌘I

Projects

Credits

Buyers

Charts

Countries

Forensics

Proponent Forensics

Satellite

Supply & Demand

API Keys

Project distribution by credit totals

Authorizations

Query Parameters

Response