> ## 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 (v1, legacy) > Retrieve the legacy (v1) forensic analysis for a specific project. **Deprecated:** Prefer the `/v2/{project_id}` endpoint which returns normalized entries, memos, and weekly diff data. Returns the raw forensic scan result including news entries JSON, price narrative, primary risk, and value proposition. Returns 404 if no analysis exists. ## OpenAPI ````yaml https://api.vcm.fyi/v1/openapi.json get /v1/forensics/{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/{project_id}: get: tags: - Forensics summary: Get project forensic analysis (v1, legacy) description: |- Retrieve the legacy (v1) forensic analysis for a specific project. **Deprecated:** Prefer the `/v2/{project_id}` endpoint which returns normalized entries, memos, and weekly diff data. Returns the raw forensic scan result including news entries JSON, price narrative, primary risk, and value proposition. Returns 404 if no analysis exists. operationId: get_forensic_news_by_project_v1_forensics__project_id__get parameters: - name: project_id in: path required: true schema: type: string title: Project Id responses: '200': description: Legacy forensic analysis with raw news entries and risk assessment content: application/json: schema: $ref: '#/components/schemas/ForensicNewsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: ForensicNewsResponse: properties: id: type: integer title: Id project_id: type: string title: Project Id project_name: anyOf: - type: string - type: 'null' title: Project Name proponent: anyOf: - type: string - type: 'null' title: Proponent registry: anyOf: - type: string - type: 'null' title: Registry country: anyOf: - type: string - type: 'null' title: Country issued: anyOf: - type: number - type: 'null' title: Issued run_date: type: string format: date-time title: Run Date status: type: string title: Status raw_json: type: string title: Raw Json news_entries_json: type: string title: News Entries Json num_findings: type: integer title: Num Findings 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 error_type: anyOf: - type: string - type: 'null' title: Error Type error_message: anyOf: - type: string - type: 'null' title: Error Message type: object required: - id - project_id - project_name - proponent - registry - country - issued - run_date - status - raw_json - news_entries_json - num_findings - price_narrative - primary_risk - value_proposition - error_type - error_message title: ForensicNewsResponse description: Response model for forensic news endpoint. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError 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 ````