# Altair GraphQL Client (GUI)

https://api-docs.lumar.io/docs/graphql-clients/altair

# Altair GraphQL Client (GUI)

[Altair GraphQL Client](https://altair.sirmuel.design/) is a customizable, cross-platform GraphQL Client for all platforms. It is built with Electron and Angular.

## Getting started

Once you have client installed you will need to load a GraphQL schema. You can do this by clicking the "Docs" button at the top right corner and then clicking the "..." button and selecting the "Load schema" option.

[![How to load schema](/img/altair/load-schema.png)](/img/altair/load-schema.png)
[![How to load schema with different extension](/img/altair/load-schema-extension.png)](/img/altair/load-schema-extension.png)

You can download Lumar GraphQL API schema from [Public schema](/docs/graphql/public-schema.md) page. Optionally
save the schema file with `.gql` extension instead of `.graphql` extension as that is the default extension for Altair.

Set the API url to `https://api.lumar.io/graphql` and method to `POST`.

## Authentication

Once you have the initial setup done, you will need to obtain session token from Lumar API. You can do this by following the steps in [Authentication](/docs/graphql/authentication.md#obtain-session-token-using-api-user-key-and-secret-token) page. You will need to use API access tokens to generate session token.

[![Creating session token](/img/altair/create-session-token.png)](/img/altair/create-session-token.png)

When you have obtained the session token, you can set it by selecting "Set Headers" option on the left sidebar and setting Header key as `x-auth-token` and header value as the session token you obtained.

[![Set x-auth-token header in Altair](/img/altair/set-header.png)](/img/altair/set-header.png)

If you have done everything correctly, you should be able to make authenticated GraphQL queries and mutations. To test authentication you can send

```graphql
query AltairCheckingAuth {
  me {
    email
  }
}
```