Skip to content

Get Started

With our GraphQL API, you can programmatically pull information about Font Awesome icons and releases.

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:

Terminal window
curl -H "Content-Type: application/json" \
-d '{ "query": "query { release (version: \"6.x\") { version } }" }' \
https://api.fontawesome.com
Terminal window
{"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 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:

Terminal window
curl -H "Content-Type: application/json" \
-H "Authorization: Bearer 123.abc.467def" \
-d '{ "query": "{ me { kits { name } } }" }' \
https://api.fontawesome.com
{"data":{"me":{"kits":[{"name":"Alpha"},{"name":"Beta"}]}}}