---
title: "API"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44574479/API"
format: markdown
---
Xray uses Jira issues to implement Test, Pre-Condition, Test Set, Test Execution and Test Plan entities. Therefore, these entities may<span style="color: #000000"> be created or updated using </span>[Jira's native REST API](https://developer.atlassian.com/cloud/jira/platform/rest/), based on <span style="color: #000000">Jira authentication</span><span style="color: #000000"> although testing information can't be managed using Jira's API.</span>

Xray itself provides a [REST API](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565892) to handle more heavy and time-consuming operations such as importing executions results, generating cucumber feature files and importing Tests.

Xray's [GraphQL API](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565894) allows users to perform CRUD operations directly on Xray entities. GraphQL <span style="color: #202020">gives clients the power to get exactly what they need and nothing more, makes it easier to evolve APIs over time, and enables powerful developer tools.</span>


Although using different patterns, these APIs work in conjunction to provide consumers ways of interacting with Xray data.


In this section: 

> Macro (children)


> ⚠️ There's a GitHub repository with many [source code snippets](https://github.com/Xray-App/xray-code-snippets), showcasing usage of the API with examples implemented in different languages (e.g., JavaScript, Java, Python).
> ⚠️ 
> ⚠️ Besides, there is another one with some[ Postman collections](https://github.com/Xray-App/xray-postman-collections) that can exemplify how to invoke these APIs, in this case using the Postman tool.
> ⚠️ 
> ⚠️ These repositories are maintained by Xray and the community; they may not be fully up-to-date but are for sure a great quick starter.
> ⚠️ 
> ⚠️ Feel free to check them out and if you have suggestions or find any problem, please raise an issue on the respective GitHub project!



> ℹ️ **Not found what you were looking for?**
> ℹ️ 
> ℹ️ - If you need to import test results, read [this page](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565311) instead, which is available at [Executing Tests](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44565037) section.
> ℹ️ - If you need to understand how to get the most out the API, please check [Clarifications on APIs usage](https://getxraydocs.atlassian.net/wiki/spaces/XRAYCLOUD/pages/44577823).