> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ixo.world/llms.txt
> Use this file to discover all available pages before exploring further.

# IXO Blocksync GraphQL API

> Read-only GraphQL query interface for indexed IXO chain data.

IXO Blocksync is an indexing and query service. It is not the canonical protocol transaction interface.

## Overview

* Use this API for indexed, flexible querying.
* Treat this as a service layer over chain data.
* Use protocol gateways for direct protocol operations.

## Service boundary

* In scope: GraphQL query patterns, filters, and pagination.
* Out of scope: transaction submission and module-level protocol semantics.

## Example queries

```graphql theme={"system"}
query {
  entities(first: 10) {
    edges {
      node {
        id
        name
        type
      }
    }
    pageInfo {
      hasNextPage
      endCursor
    }
  }
}
```

```graphql theme={"system"}
query {
  entities(
    filter: {
      type: { equalTo: "ORGANIZATION" }
      status: { equalTo: "ACTIVE" }
    }
  ) {
    edges {
      node {
        id
        name
        status
      }
    }
  }
}
```

## Authentication and endpoints

<CardGroup cols={2}>
  <Card title="Authentication matrix" href="/reference/authentication-matrix">
    Verify required credentials and auth patterns by interface.
  </Card>

  <Card title="Networks and endpoints" href="/reference/networks-and-endpoints">
    Confirm endpoint mappings by network and environment.
  </Card>
</CardGroup>

## Troubleshooting

* **GraphQL `errors` with partial `data`** — Treat the operation as failed if any required selection set is null; fix variables and filters, then retry. Log `extensions` when present for server hints.
* **Auth failures** — Service credentials differ by operator; confirm against [Authentication matrix](/reference/authentication-matrix). Do not reuse protocol wallet keys as GraphQL API keys.
* **Stale or missing entities** — Indexers lag behind chain head; wait for sync or query the same entity via RPC/REST if you need authoritative height.
* **Introspection disabled** — Some deployments turn off schema introspection in production; use a saved schema or dev environment for tooling.

## Related references

<CardGroup cols={3}>
  <Card title="Pagination" href="/api-reference/pagination">
    Apply consistent pagination patterns across API queries.
  </Card>

  <Card title="Blockchain RPC API" href="/api-reference/rpc-api">
    Use RPC endpoints for direct blockchain node interactions.
  </Card>

  <Card title="Product and SDK map" href="/reference/product-and-sdk-map">
    Navigate IXO products, APIs, and SDK references.
  </Card>
</CardGroup>