# API reference

> Reference for the IXO Protocol gateways and the IXO service APIs: what each one is for, plus the shared pages on errors, pagination and versioning.

This section is the reference for the interfaces your code calls: the two gateways to the IXO
Protocol, and the services that run beside the chain. Each page covers one interface: its scope,
how to reach it, example shapes and what goes wrong.

It does not explain protocol concepts and does not list hosts. For the hosts and chain ids of each
network, use [Networks and endpoints](/reference/networks-and-endpoints). To choose between the
interfaces, start at the comparison table in [Choose an API](/api-reference/intro-apis).

## The interfaces

| API | Kind | Use it to |
| --- | --- | --- |
| [Blockchain RPC API](/api-reference/rpc-api) | IXO Protocol gateway | Send transactions and query chain state directly on a node |
| [Blockchain REST API](/api-reference/grpc-gateway-api) | IXO Protocol gateway | Query IXO Protocol modules over HTTP and JSON, through the gateway over gRPC |
| [IXO Blocksync GraphQL API](/api-reference/blocksync-graphql-api) | Service API | Query indexed chain data through IXO Blocksync |
| [Matrix state bot API](/api-reference/matrix-state-bot-api) | Service API | Read and manage state and ACL events in IXO Matrix rooms |
| [Registry API](/api-reference/registry-api) | Service API | Call Impact Hub Registry service workflows |
| [USSD gateway API](/api-reference/ussd-api) | Service API | Accept input from telecom gateways and return USSD responses |

## Boundary between protocol and services

- IXO Protocol APIs: `rpc-api` and `grpc-gateway-api`.
- Service APIs: `blocksync-graphql-api`, `matrix-state-bot-api`, and `registry-api`.
- Protocol concepts and module behaviour belong in the protocol documentation, such as
  [IXO Protocol](/protocols/ixo-protocol), not on these pages.

## Shared references

| Page | What it covers |
| --- | --- |
| [Authentication](/api-reference/authentication) | Authentication schemes compared by API |
| [Errors](/api-reference/errors) | Status codes, the error body and rate-limit headers |
| [Pagination](/api-reference/pagination) | Cursor arguments for large result sets |
| [Versioning and deprecation](/api-reference/versioning) | How versions are named and how a retirement is announced |
| [Networks and endpoints](/reference/networks-and-endpoints) | Hosts and chain ids for each network |
| [Authentication matrix](/reference/authentication-matrix) | Authentication requirements and literals by interface |
| [Product and SDK map](/reference/product-and-sdk-map) | IXO products, APIs and SDK references |

## Next steps

<CardGroup cols={2}>
  <Card title="Choose an API" icon="list" href="/https/docs.ixo.world/api-reference/intro-apis">
    Compare the interfaces side by side before you build.
  </Card>
  <Card title="SDK reference" icon="code" href="/https/docs.ixo.world/sdk-reference">
    The IXO SDKs and their packages.
  </Card>
</CardGroup>
