> ## 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 latest forensic news feed > Retrieve the most recent AI-detected news entries across all projects — a global forensics news feed. Each entry represents a news event discovered during the weekly AI scan of 100+ sources using Gemini with Google Search grounding. Entries include the key event summary, market impact assessment, source URL, category, and detection metadata. **New this week:** The `is_new_this_week` flag is `true` only for entries where the project has genuinely new findings (after semantic deduplication against previous scans). **Filtering:** Use `category` to filter by event type. Each entry is enriched with project context (name, country, proponent, registry). ## OpenAPI ````yaml https://api.vcm.fyi/v1/openapi.json get /v1/forensics/v2/latest 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/latest: get: tags: - Forensics summary: Get latest forensic news feed description: >- Retrieve the most recent AI-detected news entries across all projects — a global forensics news feed. Each entry represents a news event discovered during the weekly AI scan of 100+ sources using Gemini with Google Search grounding. Entries include the key event summary, market impact assessment, source URL, category, and detection metadata. **New this week:** The `is_new_this_week` flag is `true` only for entries where the project has genuinely new findings (after semantic deduplication against previous scans). **Filtering:** Use `category` to filter by event type. Each entry is enriched with project context (name, country, proponent, registry). operationId: get_latest_news_v1_forensics_v2_latest_get parameters: - name: limit in: query required: false schema: type: integer maximum: 200 minimum: 1 description: Max entries to return default: 50 title: Limit description: Max entries to return - name: category in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by category title: Category description: Filter by category responses: '200': description: Latest forensic news entries with new-this-week counts content: application/json: schema: $ref: '#/components/schemas/LatestForensicNewsResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: LatestForensicNewsResponse: properties: entries: items: $ref: '#/components/schemas/ForensicNewsEntryResponse' type: array title: Entries total_count: type: integer title: Total Count new_this_week_count: type: integer title: New This Week Count week: type: integer title: Week year: type: integer title: Year type: object required: - entries - total_count - new_this_week_count - week - year title: LatestForensicNewsResponse description: Response for latest news feed across all projects. 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. 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 ````