generated: '2026-08-07'
method: searched
source: https://api-docs.bezerocarbonmarkets.com/
note: Response examples published verbatim in BeZero's own OpenAPI. BeZero puts them on schema.example rather than
  content.example. Saved unmodified; the values are BeZero's own placeholders, not live rating data.
examples:
- operationId: listRatings
  method: GET
  path: /ratings
  status: 200
  media_type: application/json
  location_in_spec: content.application/json.schema.example
  source_operation: openapi/bezero-carbon-ratings-openapi.yml#listRatings
  example:
    ratings:
    - id: ABC123
      projectID: ABC123
      accreditor: Full Accreditor Name
      registryID: '123'
      vintages:
      - startDate: '2017-04-28'
        endDate: '2020-11-30'
      - startDate: '2020-12-01'
        endDate: '2021-11-30'
      rating: BB
      onRatingsWatch: false
      summaryAnalysis: Example summary analysis for this rating.
      platformURL: https://bezerocarbonmarkets.com/projects/ABC123
      dataLastUpdatedAt: '2024-09-09T10:00:00Z'
      links:
        ratingDetails: /ratings/ABC123
        riskFactors: /ratings/ABC123/risk-factors
    - id: ABC123-POST-JJK
      projectID: ABC123
      accreditor: Full Accreditor Name
      registryID: '123'
      vintages:
      - startDate: '2021-12-01'
        endDate: '2022-11-30'
      rating: AA
      onRatingsWatch: true
      summaryAnalysis: Example summary analysis for this rating.
      platformURL: https://bezerocarbonmarkets.com/projects/ABC123
      dataLastUpdatedAt: '2024-09-08T09:00:00Z'
      links:
        ratingDetails: /ratings/ABC123-POST-JJK
        riskFactors: /ratings/ABC123-POST-JJK/risk-factors
    - id: DEF123
      projectID: DEF123
      accreditor: Full Accreditor Name
      registryID: DEF123
      vintages:
      - startDate: '2010-01-01'
        endDate: '2015-12-31'
      rating: A
      onRatingsWatch: false
      summaryAnalysis: Example summary analysis for this rating.
      platformURL: https://bezerocarbonmarkets.com/projects/DEF123
      dataLastUpdatedAt: '2024-09-07T10:00:00Z'
      links:
        ratingDetails: /ratings/DEF123
        riskFactors: /ratings/DEF123/risk-factors
    - id: GH1000000100
      projectID: GH1000000100
      accreditor: Full Accreditor Name
      registryID: GH_100000_100
      vintages:
      - startDate: '2012-01-01'
        endDate: '2020-12-31'
      rating: AA
      onRatingsWatch: false
      summaryAnalysis: Example summary analysis for this rating.
      platformURL: https://bezerocarbonmarkets.com/projects/GH1000000100
      dataLastUpdatedAt: '2024-09-07T10:00:00Z'
      links:
        ratingDetails: /ratings/GH1000000100
        riskFactors: /ratings/GH1000000100/risk-factors
    links:
      queryLatestChanges: /ratings?changedSince=2024-09-06T09:00:00Z
      nextPage: /ratings?page=2
      prevPage: /ratings?page=1
- operationId: getRiskFactors
  method: GET
  path: /ratings/{ratingID}/risk-factors
  status: 200
  media_type: application/json
  location_in_spec: content.application/json.schema.example
  source_operation: openapi/bezero-carbon-ratings-openapi.yml#getRiskFactors
  example:
    id: ABC123
    additionality:
      score: aa
    carbonAccounting:
      score: c
    permanence:
      score: bbb
- operationId: listProjects
  method: GET
  path: /projects
  status: 200
  media_type: application/json
  location_in_spec: content.application/json.schema.example
  source_operation: openapi/bezero-carbon-ratings-openapi.yml#listProjects
  example:
    projects:
    - id: ABC123
      accreditor: Full Accreditor Name
      registryID: '123'
      name: Full Project Name
      sectorGroup: Nature-Based Solutions
      sector: Blue Carbon
      subSector: Mangroves
      location: MMR
      dataLastUpdatedAt: '2024-09-08T09:00:00Z'
    - id: DEF123
      accreditor: Full Accreditor Name
      registryID: DEF123
      name: Full Project Name
      sectorGroup: Nature-Based Solutions
      sector: Soil Carbon & Agriculture
      subSector: Peatlands
      location: IDN
      dataLastUpdatedAt: '2024-09-07T10:00:00Z'
    - id: GH1000000100
      accreditor: Full Accreditor Name
      registryID: GH_1000000_100
      name: Full Project Name
      sectorGroup: Nature-Based Solutions
      sector: Forestry
      subSector: Afforestation, Reforestation & Restoration
      location: BRA
      dataLastUpdatedAt: '2024-09-07T10:00:00Z'
    links:
      queryLatestChanges: /projects?changedSince=2024-09-06T09:00:00Z
      nextPage: /projects?page=2
      prevPage: /projects?page=1
coverage:
  operations: 4
  operations_with_response_example: 3
  operations_with_request_example: 0
  note: BeZero publishes response examples on 3 of 4 operations (listRatings, listProjects, getRiskFactors). getRatingDetails
    — the operation BeZero itself marks deprecated — ships none. No request examples exist, though every operation
    is a GET with at most two query parameters.