> ## Documentation Index > Fetch the complete documentation index at: https://docs.api.vcm.fyi/llms.txt > Use this file to discover all available pages before exploring further. # Get project forensic analysis (v2) > Retrieve the full AI forensic analysis for a specific project, including all detected news entries, the current risk memo, and scan statistics. **Response structure:** - **entries:** All news events detected for this project, sorted by first seen date (most recent first). Each entry includes category, source, key event summary, market impact, URL, and whether it was new this week. - **memo:** The current AI-generated risk assessment including price narrative, primary risk, value proposition, operational status, methodology risk, quality tier estimate, deal flow signals, and investment thesis. - **stats:** Total entry count, new entries this week, last scan date, week/year. Falls back to the v1 legacy table if no v2 data exists for the project. Returns 404 if no forensic data exists at all. ## OpenAPI ````yaml https://api.vcm.fyi/v1/openapi.json get /v1/forensics/v2/{project_id} openapi: 3.1.0 info: title: VCM.fyi API version: 1.0.0 description: > # VCM.fyi API Programmatic access to carbon market intelligence — covering 11,000+ carbon credit projects across 6 major registries (Verra, Gold Standard, CAR, ACR, Isometric, Puro Earth). ## Resources | Resource | Description | |---|---| | **Projects** | Search, filter, and retrieve carbon credit project metadata | | **Credits** | Individual credit transactions (issuances, retirements, cancellations) | | **Buyers** | Aggregated buyer intelligence from retirement transaction data | | **Charts** | Pre-aggregated chart data for visualizations | | **Countries** | Country-level carbon market policy intelligence (Article 6, CORSIA, carbon pricing) | | **Forensics** | AI-generated project risk analysis from weekly news scanning | | **Proponent Forensics** | Developer/proponent-level risk ratings and due diligence | | **Satellite** | Forest integrity and deforestation metrics | | **Supply & Demand** | Aggregated issuance vs. retirement volumes over time | | **API Keys** | Manage your API keys and view usage statistics | ## Authentication All endpoints require an API key passed in the `X-API-KEY` header: ```bash curl -H "X-API-KEY: vcm_live_your_key_here" https://api.vcm.fyi/v1/projects/ ``` Get your API key at [app.vcm.fyi/settings/api](https://app.vcm.fyi/settings/api). ## Rate Limits | Plan | Requests/min | Monthly Calls | |------|-------------|---------------| | Pro | 300 | 100,000 | | Enterprise | 1,000 | Unlimited | Rate limit headers are included in every response: - `X-RateLimit-Limit` — Your limit per minute - `X-RateLimit-Remaining` — Remaining requests in current window - `X-RateLimit-Reset` — Unix timestamp when the window resets ## Pagination List endpoints return paginated results: ```json { "pagination": { "total_entries": 11234, "current_page": 1, "total_pages": 113, "next_page": "/v1/projects/?current_page=2&per_page=100" }, "data": [...] } ``` contact: name: VCM.fyi Support email: support@vcm.fyi url: https://vcm.fyi termsOfService: https://vcm.fyi/terms x-logo: url: https://app.vcm.fyi/logo.svg altText: VCM.fyi servers: - url: https://vcm-fyi-api.fly.dev description: Production security: [] tags: - name: API Keys description: Create, list, revoke your API keys and view usage statistics. - name: Buyers description: >- Aggregated buyer intelligence derived from retirement transactions. Includes volume metrics, activity flags, category/country breakdowns, and analytics. - name: Charts description: >- Pre-aggregated chart data for visualizations: projects by listing date, credits by transaction date, category breakdowns, credit histograms, and top buyers. - name: Countries description: >- Country-level carbon market policy intelligence covering Article 6 status, CORSIA eligibility, carbon pricing, VCM regulation, and AI-generated policy summaries. - name: Credits description: >- Query individual credit transactions — issuances, retirements, and cancellations — with quantity, vintage, date, and beneficiary details. - name: Forensics description: >- AI-generated project risk analysis from weekly scanning of 100+ news sources. Includes entries, memos, weekly diffs, and legacy v1 endpoints. - name: Projects description: >- Search, filter, and retrieve metadata for 11,000+ carbon credit projects across Verra, Gold Standard, CAR, ACR, Isometric, and Puro Earth. - name: Proponent Forensics description: >- Developer/proponent-level risk ratings and due diligence analysis with governance, financial, legal, social, and institutional risk pillar scores. - name: Satellite description: >- Forest integrity and deforestation metrics from Global Forest Watch, including tree cover loss, GLAD alerts, fire alerts, and project boundary GeoJSON. - name: Supply & Demand description: >- Aggregated issuance (supply) vs. retirement (demand) volumes over time, with monthly, quarterly, or yearly aggregation. paths: /v1/forensics/v2/{project_id}: get: tags: - Forensics summary: Get project forensic analysis (v2) description: >- Retrieve the full AI forensic analysis for a specific project, including all detected news entries, the current risk memo, and scan statistics. **Response structure:** - **entries:** All news events detected for this project, sorted by first seen date (most recent first). Each entry includes category, source, key event summary, market impact, URL, and whether it was new this week. - **memo:** The current AI-generated risk assessment including price narrative, primary risk, value proposition, operational status, methodology risk, quality tier estimate, deal flow signals, and investment thesis. - **stats:** Total entry count, new entries this week, last scan date, week/year. Falls back to the v1 legacy table if no v2 data exists for the project. Returns 404 if no forensic data exists at all. operationId: get_forensic_news_v2_v1_forensics_v2__project_id__get parameters: - name: project_id in: path required: true schema: type: string title: Project Id responses: '200': description: Complete forensic analysis with entries, memo, and scan statistics content: application/json: schema: $ref: '#/components/schemas/ForensicNewsV2Response' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: ForensicNewsV2Response: properties: project_id: type: string title: Project Id entries: items: $ref: '#/components/schemas/ForensicNewsEntryResponse' type: array title: Entries memo: anyOf: - $ref: '#/components/schemas/ForensicNewsMemoResponse' - type: 'null' stats: $ref: '#/components/schemas/ForensicNewsStatsResponse' type: object required: - project_id - entries - memo - stats title: ForensicNewsV2Response description: Full forensic news response with entries, memo, and stats. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ForensicNewsEntryResponse: properties: id: type: integer title: Id project_id: type: string title: Project Id entry_hash: type: string title: Entry Hash date: anyOf: - type: string - type: 'null' title: Date category: anyOf: - type: string - type: 'null' title: Category source: anyOf: - type: string - type: 'null' title: Source key_event: anyOf: - type: string - type: 'null' title: Key Event market_impact: anyOf: - type: string - type: 'null' title: Market Impact url: anyOf: - type: string - type: 'null' title: Url first_seen_date: type: string format: date title: First Seen Date first_seen_week: type: integer title: First Seen Week first_seen_year: type: integer title: First Seen Year is_new_this_week: type: boolean title: Is New This Week default: false project_name: anyOf: - type: string - type: 'null' title: Project Name project_country: anyOf: - type: string - type: 'null' title: Project Country project_proponent: anyOf: - type: string - type: 'null' title: Project Proponent project_registry: anyOf: - type: string - type: 'null' title: Project Registry type: object required: - id - project_id - entry_hash - date - category - source - key_event - market_impact - url - first_seen_date - first_seen_week - first_seen_year title: ForensicNewsEntryResponse description: Response model for a single news entry. ForensicNewsMemoResponse: properties: project_id: type: string title: Project Id price_narrative: anyOf: - type: string - type: 'null' title: Price Narrative primary_risk: anyOf: - type: string - type: 'null' title: Primary Risk value_proposition: anyOf: - type: string - type: 'null' title: Value Proposition future_issuance_assessment: anyOf: - type: string - type: 'null' title: Future Issuance Assessment project_operational_status: anyOf: - type: string - type: 'null' title: Project Operational Status development_status: anyOf: - type: string - type: 'null' title: Development Status estimated_issuance_timeline: anyOf: - type: string - type: 'null' title: Estimated Issuance Timeline methodology_risk: anyOf: - type: string - type: 'null' title: Methodology Risk quality_tier_estimate: anyOf: - type: string - type: 'null' title: Quality Tier Estimate proponent_assessment: anyOf: - type: string - type: 'null' title: Proponent Assessment deal_flow_signals: anyOf: - type: string - type: 'null' title: Deal Flow Signals investment_thesis: anyOf: - type: string - type: 'null' title: Investment Thesis scan_type: anyOf: - type: string - type: 'null' title: Scan Type last_updated: type: string format: date title: Last Updated total_entries: type: integer title: Total Entries type: object required: - project_id - price_narrative - primary_risk - value_proposition - last_updated - total_entries title: ForensicNewsMemoResponse description: Response model for project memo. ForensicNewsStatsResponse: properties: total_entries: type: integer title: Total Entries new_this_week: type: integer title: New This Week last_scan_date: anyOf: - type: string format: date - type: 'null' title: Last Scan Date week_number: type: integer title: Week Number year: type: integer title: Year type: object required: - total_entries - new_this_week - last_scan_date - week_number - year title: ForensicNewsStatsResponse description: Stats about forensic news for a project. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: APIKeyHeader: type: apiKey in: header name: X-API-KEY ````