> For the complete documentation index, see [llms.txt](https://support.ordereazi.com/central/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.ordereazi.com/central/developers/finding-your-api-reference.md).

# Finding your API reference

Where to find the full OrderEazi API reference, with every endpoint and field, and how to try calls from it.

These help pages explain how the OrderEazi API works, but not every field. For that, each organisation's OrderEazi address has a full reference, with every endpoint, field, and response. It always matches the OrderEazi release the organisation is on, which is the `Version` that `/api/ping` returns.

### How to open the reference

Go to the organisation's OrderEazi address, followed by `/api/v2/`, such as `https://yourcompany.ordereazi.com/api/v2/`. You don't need to sign in or use a key to read it. This address is only for the reference: API calls have no version in the address. See [API versions](/central/developers/api-versions.md).

Users with the **API Keys** permission can also go to **Integrations** > **API Keys** and select **Api Reference**.

The reference shows version 2.0. Version 1.0 has the same endpoints, except those added in version 2.0, and a few of them return a different shape.

### How to try a call

> **Warning:** Calls made from the reference are real calls. Write calls change the organisation's data, and every call counts towards your key's [rate limit](/central/developers/rate-limits.md). Test write calls on a test organisation, not a live one.

1. In the reference, select an endpoint.
2. Open its test request.
3. Enter your key in the `X-OrderEazi-Key` field.
4. Fill in the parameters or the request body.
5. Send the request.

The response appears with its status code, headers, and body.

### How to get the OpenAPI file

To generate a client library in your own programming language, download the OpenAPI file. The version 2.0 file is at `https://yourcompany.ordereazi.com/api/v2/swagger.json`, and the version 1.0 file is at `https://yourcompany.ordereazi.com/api/v1/swagger.json`. Opening one in a browser downloads it.

### Related pages

* [Getting started with the API](/central/developers/getting-started-with-the-api.md): your first call
* [Authentication](/central/developers/authentication.md): keys and permissions
