# Get Started

Overview and documentation for using the Font Awesome GraphQL API.

> With our [GraphQL API](https://graphql.org), you can programmatically pull information about Font Awesome icons and releases.

  <h4>
   Need a hand?
  </h4>
  You can use a [GraphiQL client](https://graphql.org/graphql-js/graphql-clients) to
  explore the schema and build queries.

## Make a Request for Public Metadata

Most fields in the schema are public and require no authorization.

Here's a `curl` command to get the latest version of Font Awesome:

```bash
curl -H "Content-Type: application/json" \
-d '{ "query": "query { release (version: \"7.x\") { version } }" }' \
https://api.fontawesome.com
```

```bash
{"data":{"release":{"version":"VERSION"}}}
```

## Make an Authorized Request

Requests whose queries access fields that require authorization should include
an access token in the `Authorization` header. (Use the [Token Endpoint](/apis/graphql/token-endpoint.md) to resolve your API token into an access token.)

Suppose you have an active access token `123.abc.467def`, and that you have two kits in your account: one named "Alpha" and the other named "Beta". This query will return the list of kit names:

```bash
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer 123.abc.467def" \
-d '{ "query": "{ me { kits { name } } }" }' \
https://api.fontawesome.com
```

```js
{"data":{"me":{"kits":[{"name":"Alpha"},{"name":"Beta"}]}}}
```