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

# Introduction

> Introduction to Filed APIs

# GraphQL Introduction

> Powerful GraphQL API for flexible server management and real-time data querying

The Filed GraphQL API provides a flexible, efficient way to query and manage your taxpreps. Unlike REST APIs, GraphQL allows you to request exactly the data you need in a single request, reducing over-fetching and improving performance.

## Key Features

* **Flexible Queries**: Request only the data you need
* **Type Safety**: Strongly typed schema with comprehensive documentation
* **Single Endpoint**: All operations through one GraphQL endpoint

## Getting Started

### Endpoint

```
https://router.apps.filed.com/graphql
```

### Authentication

All GraphQL requests require authentication using a Bearer token in the Authorization header.

```http theme={null} theme={null}
Authorization: Bearer YOUR_JWT_ACCESS_TOKEN
```

### Basic Query Example

```graphql theme={null} theme={null}
query Health {
  health {
    id
    ai
    platform
  }
}
```

## GraphQL desktop client

Explore the GraphQL API interactively using a desktop client:

<CardGroup cols={1}>
  <Card title="GraphQL desktop client" icon="play" href="https://httpie.io/docs/desktop/graphql">
    Test queries with this desktop client (Httpie)
  </Card>
</CardGroup>

## Benefits Over REST

<AccordionGroup>
  <Accordion title="Reduced Network Requests">
    Fetch multiple related resources in a single request instead of multiple REST calls.
  </Accordion>

  <Accordion title="Client-Specified Data">
    Request only the fields you need, reducing payload size and improving
    performance.
  </Accordion>

  <Accordion title="Type Safety">
    Strongly typed schema prevents runtime errors and improves developer experience.
  </Accordion>
</AccordionGroup>

## Next steps

* **Authentication**: Create an API key and exchange it for an access token in the [Authentication guide](/guides/authentication).
* **Quickstart**: Go from zero to a processed client in five steps in the [Quickstart](/guides/quickstart).
* **Making requests**: Learn the request shape, variables, and the error model in [Making requests](/guides/making-requests).
* **Uploading documents**: Stage files through the resumable upload endpoint and attach them to a client in the [Uploading documents guide](/guides/uploading-documents).
* **API reference**: Browse the operations, [`health`](/apis/health), [`me`](/apis/me), [Clients](/apis/clients), [Tasks](/apis/tasks), and [Conventions](/apis/conventions), in the [API reference](/apis/introduction).

<Info>
  Looking for the previous REST API? It is preserved under [Legacy](/legacy/apis/introduction).
</Info>