The Voxel API is organised around GraphQL. Ymage chose GraphQL for our Voxel API because it offers significantly more flexibility for our integrators. GraphQL provides a complete and understandable description of the data in our API, gives you the power to ask for exactly what you need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.


To authenticate with the GraphQL api, you need an API access token. This token can be requested by contacting Keep this token in a safe place. This token can be used as a bearer token for authenticating with the Voxel API.


To test out the API we recommend using GraphiQL or another standalone client (e.g., Postman or Insomnia)

Dates and times

All date/time arguments need to be in ISO 8601 format. Fields containing date/time will always be in ISO 8601 format.

  • Calendar dates: YYYY-MM-DD (e.g., 2021-03-17T09)
  • Date and time: YYYY-MM-DDThh:mm:ssZ (e.g., 2021-03-17T09:20:28.994Z)
# Method + URL

# Headers
  - authorization: Bearer <your-api-token>
  - content-type: application/json