> ## Documentation Index
> Fetch the complete documentation index at: https://ixoworld-mintlify-9a7944b6.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Emerging Platform API surfaces

> Understand platform API surfaces and how Emerging Household Energy integrations consume them.

This page documents **Emerging Platform** API surfaces and cross-product IXO dependencies. Use it to choose integration entry points. For household-energy workflows, use the linked **Emerging Household Energy** guides.

## Service APIs

<CardGroup>
  <Card title="Impact Hub" icon="server">
    Blockchain APIs for registry and verification services
  </Card>

  <Card title="Blocksync" icon="database">
    Dynamic querying of indexed blockchain data using GraphQL
  </Card>

  <Card title="Data Matrix" icon="vault">
    Secure Matrix Server interface to private data rooms
  </Card>
</CardGroup>

## API Architecture

### Core Services

<CardGroup>
  <Card title="Registry API" icon="book" href="/api-reference/registry-api">
    Register and manage digital twins
  </Card>

  <Card title="Verification API" icon="check-double" href="/platforms/Emerging/data-integrity">
    Process and validate claims
  </Card>

  <Card title="Data API" icon="database" href="/articles/ixo-matrix">
    Store and retrieve secure data
  </Card>

  <Card title="Oracle API" icon="sparkles" href="/articles/agentic-oracles">
    Access AI services
  </Card>
</CardGroup>

## Authentication

<AccordionGroup>
  <Accordion title="API Keys">
    * Required for all API requests
    * Managed through Mission Control
    * Capability-based access control
    * Environment-specific keys
  </Accordion>

  <Accordion title="Authorization">
    ```bash theme={null}
    Authorization: Bearer YOUR_API_KEY
    ```

    Include your API key in all request headers
  </Accordion>

  <Accordion title="Security">
    * TLS encryption required
    * Key rotation policies
    * Rate limiting enforced
    * Request logging
  </Accordion>
</AccordionGroup>

## Service Endpoints

### Production APIs

<AccordionGroup>
  <Accordion title="Impact Hub Network">
    * Registry: `https://registry.emerging.eco/v1`
    * Claims: `https://claims.emerging.eco/v1`
    * Verification: `https://verify.emerging.eco/v1`
  </Accordion>

  <Accordion title="Data Services">
    * Matrix: `https://matrix.emerging.eco/v1`
    * Storage: `https://storage.emerging.eco/v1`
    * Query: `https://query.emerging.eco/v1`
  </Accordion>

  <Accordion title="Oracle Services">
    * AI Verification: `https://oracles.emerging.eco/v1`
    * Analytics: `https://analytics.emerging.eco/v1`
  </Accordion>
</AccordionGroup>

## Response Format

### Standard Response

<AccordionGroup>
  <Accordion title="Success Response">
    ```json theme={null}
    {
      "success": true,
      "data": {
        // Response data
      }
    }
    ```
  </Accordion>

  <Accordion title="Error Response">
    ```json theme={null}
    {
      "success": false,
      "error": {
        "code": "ERROR_CODE",
        "message": "Human readable message"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## Integration Guide

1. [Get API credentials](/guides/dev/authentication)
2. [Choose service endpoints](/reference/networks-and-endpoints)
3. [Implement authentication](/guides/dev/authentication)
4. [Handle responses](/api-reference/authentication)

## Developer Tools

<CardGroup>
  <Card title="API Reference" icon="book" href="/api-reference/blocksync-graphql-api">
    Complete API documentation
  </Card>

  <Card title="SDKs" icon="code" href="/sdk-reference/index">
    Client libraries and tools
  </Card>

  <Card title="Examples" icon="lightbulb" href="/guides/dev/examples">
    Sample integrations
  </Card>

  <Card title="Support" icon="headset" href="https://ixofoundation.slack.com/archives/C04UERAUHQT">
    Developer assistance
  </Card>
</CardGroup>

## Best Practices

<CardGroup>
  <Card title="Rate Limiting" icon="gauge">
    Implement proper request throttling
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation">
    Handle errors gracefully
  </Card>

  <Card title="Security" icon="shield">
    Follow security guidelines
  </Card>

  <Card title="Monitoring" icon="chart-line">
    Track API usage and performance
  </Card>
</CardGroup>