> 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/api-guides/reference-data.md).

# Reference data

The OrderEazi API endpoints for reference data: warehouses, branches, currencies, pricelists, brands, categories, users, sales channels, and more.

Other API calls need IDs and names from lists, such as the warehouse to send stock to. The OrderEazi reference data endpoints return those lists, and some let you add to them.

### Before you start

You need **Read** on **For Administrative Data** to read these lists, and **Write** to change them, unless the table says otherwise. See [Authentication](/central/developers/authentication.md).

### Reference data endpoints

| Data                   | Endpoints                                                                                                                           | Notes                                                                                                                                                              |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Warehouses**         | `GET /api/warehouse`, `POST /api/warehouse`                                                                                         | Creating a warehouse is version 2.0 only.                                                                                                                          |
| **Locations**          | `GET /api/warehouse/{warehouseId}/location`, `GET /api/location`, `POST /api/location`, `POST /api/location/batch`                  | Bins and areas in a warehouse. `POST /api/location/batch` skips locations that already exist.                                                                      |
| **Branches**           | `GET /api/branch`, `POST /api/branch`, and `/api/branch/{branchId}/warehouses`, `/pricing`, and `/clients`                          | `POST` creates or updates a branch. `DELETE /api/branch/{name}` disables it.                                                                                       |
| **Sales channels**     | `GET /api/saleschannel/list`, `POST`, `PATCH`, and `DELETE /api/saleschannel`, and `/api/saleschannel/{channelId}/warehouses`       | A sales channel is the setup an outside system's orders come through. Its warehouse order sets which warehouse those orders take stock from first.                 |
| **Pricelists**         | `GET /api/pricelists`, `POST /api/pricelists`, `POST /api/pricelists/{pricelistId}`                                                 | A pricelist is a set of selling prices. These need **For Products**. See [Products and stock levels](/central/developers/api-guides/products-and-stock-levels.md). |
| **Brands**             | `GET` and `POST /api/brand`, and `GET`, `PATCH`, and `DELETE /api/brand/{id}`                                                       |                                                                                                                                                                    |
| **Categories**         | `GET /api/category/list`, `GET /api/category/{name}`, `POST /api/category/create`, `PUT /api/category/update`                       | Send a `ParentId` to create a sub-category.                                                                                                                        |
| **Currencies**         | `GET /api/currency/list`, `GET /api/currency/rate?from=USD&to=ZAR`                                                                  | `/api/currency/rate` returns a live market rate, not the organisation's own rates.                                                                                 |
| **Exchange rates**     | `GET`, `PUT`, and `DELETE /api/exchange-rate`, and `PUT /api/exchange-rate/batch`                                                   | The organisation's own exchange rates.                                                                                                                             |
| **Product behaviours** | `GET /api/productbehaviour/list`                                                                                                    | Use the `Id` as a product's `ProductBehaviourId`.                                                                                                                  |
| **Branding**           | `POST /api/ubc/types/batch`, `POST /api/ubc/groups/batch`                                                                           | Create or update branding types and groups for the Universal Branding Calculator (logos and decoration added to products).                                         |
| **Industries**         | `GET /api/industry/list`, `POST /api/industry/create`, and `GET`, `PATCH`, and `DELETE /api/industry/{id}`                          |                                                                                                                                                                    |
| **Teams**              | `GET /api/team/list`, `POST /api/team/create`, `POST /api/team`, and `/api/team/{teamId}`                                           | `POST /api/team` creates or updates teams by `Code`.                                                                                                               |
| **Users**              | `GET` and `POST /api/user`, `GET /api/user/{id}`, `PUT /api/user/role`, and `/api/user/{userId}/branches`, `/teams`, and `/clients` | `PUT /api/user/role` resets a user's permissions to their role's.                                                                                                  |
| **Roles**              | `GET /api/role/role`, `GET /api/role/role/{name}`                                                                                   | Note the repeated `role` in the path.                                                                                                                              |
| **Workflows**          | `GET /api/workflow/list`                                                                                                            | Returns each workflow and its steps.                                                                                                                               |
| **Delivery types**     | `GET /api/order/deliverytype`                                                                                                       | Use the `Code` as an order's `DeliveryType`.                                                                                                                       |
| **Ledger accounts**    | `GET /api/ledger/list`                                                                                                              | The ledger accounts from the organisation's accounting system.                                                                                                     |
| **Organisation**       | `GET /api/organization/detail`                                                                                                      | The organisation's own details.                                                                                                                                    |

The [API reference](/central/developers/finding-your-api-reference.md) has each endpoint's fields.

### Related pages

* [Receiving orders from a sales channel](/central/developers/api-guides/receiving-orders-from-a-sales-channel.md): orders use sales channels and delivery types
* [Products and stock levels](/central/developers/api-guides/products-and-stock-levels.md): stock uses warehouses and locations