---
title: Environments
description: Doshii has multiple environments which are completely distinct and used for different purposes. Each environment has a base API URL of https://&lt;environment&gt;.doshii.co/. In addition, we also offer a re
---

[Skip to content](https://support.doshii.com/developer-support/hc/en-us/articles/11799468646553-environments#main-content)

English

Show submenu for translations

Doshii Connect Pty Ltd

Open main navigation

Close main navigation

- English
  
  Show submenu for translations
- Go to Doshii Connect Pty Ltd

 Go to Doshii Connect Pty Ltd

 Help for Partners

- There are no suggestions because the search field is empty.

1. [Help for Partners](https://support.doshii.com/developer-support?hsLang=en)
2. [API concepts](https://support.doshii.com/developer-support/api-concepts?hsLang=en)

# Environments

Doshii has multiple environments which are completely distinct and used for different purposes.

Each environment has a base API URL of `https://<environment>.doshii.co/`. In addition, we also offer a read-only suite of endpoints for certified Apps, that are optimised for read-only access. They function exactly the same as the standard suite of endpoints, in terms of behaviour and schema, however, only `GET` requests are supported. The read-only endpoints base API URL is `https://<environment>-readonly.doshii.co/`.

To better support analytics and data aggregation Apps, we have released a [Bulk Data API](https://support.doshii.io/hc/en-us/sections/360002681134) to handle large requests for data in a single call. The Bulk Data endpoints base API URL is `https://data.<environment>.doshii.co/`.

The first segment in the URL path will be either `partner` or `pos`, depending on which you classify as, the exception being the Bulk Data API, where no classification is required. The second segment for the API will contain the current [Doshii API version](https://support.doshii.io/hc/en-us/articles/360000657674-Version).

For socket connections, (both [Apps](https://support.doshii.io/hc/en-us/articles/360000649633-Use-of-WebSockets) and [POS](https://support.doshii.io/hc/en-us/articles/360000649613-Use-of-WebSockets)), the last segment in the Url path will be `socket`, e.g. `https://<environment>.doshii.co/app/socket`.

### Live

Used exclusively for actual trading. Only real Locations associated with certified Vendors and able to be accessed by certified Apps.

- **POS URLs**: 
    - API Base: `https://live.doshii.co/pos/<version>`
    - Socket: `wss://socket.live.doshii.co/pos/socket` (or `wss://socket.live.doshii.co/vendor/socket` for Cloud POS)
- **Partner URLs**: 
    - API Base: `https://live.doshii.co/partner/<version>`
    - Read-Only API Base: `https://readonly.live.doshii.co/partner/<version>`
    - Data API Base: `https://data.live.doshii.co/<version>`
    - Socket URL: `https://socket.live.doshii.co/`

Every precaution has been taken to eliminate downtime and maximise resilience on this environment. Please remember to include the [version](https://support.doshii.io/hc/en-us/articles/360000657674-Version) in your requests.

### Sandbox

For development and testing purposes. This environment may be on a different version to live.

We offer this environment to allow developers to adapt their applications to upcoming changes and give the opportunity for community feedback.

- **POS URLs**: 
    - API Base: `https://sandbox.doshii.co/pos/<version>`
    - Socket: `wss://socket.sandbox.doshii.co/pos/socket` (or `wss://socket.sandbox.doshii.co/vendor/socket` for Cloud POS)
- **Partner URLs**: 
    - API Base: `https://sandbox.doshii.co/partner/<version>`
    - Read-Only API Base: `https://readonly.sandbox.doshii.co/partner/<version>`
    - Data API Base: `https://data.sandbox.doshii.co/<version>`
    - Socket URL: `wss://socket.sandbox.doshii.co/app/socket`

Please remember to include the [version](https://support.doshii.io/hc/en-us/articles/360000657674-Version) in your requests.

- [API concepts](https://support.doshii.com/developer-support/api-concepts?hsLang=en)
- [Members](https://support.doshii.com/developer-support/members?hsLang=en)
- [Model](https://support.doshii.com/developer-support/model?hsLang=en)
- [FAQ - Developers](https://support.doshii.com/developer-support/faq-developers?hsLang=en)
- [Resources](https://support.doshii.com/developer-support/resources?hsLang=en)
- [Orders](https://support.doshii.com/developer-support/orders?hsLang=en)
- [Rewards](https://support.doshii.com/developer-support/rewards?hsLang=en)
- [Check-ins](https://support.doshii.com/developer-support/check-ins?hsLang=en)
- [Getting started - App partners](https://support.doshii.com/developer-support/getting-started-app-partners?hsLang=en)
- [Employees](https://support.doshii.com/developer-support/employees?hsLang=en)
- [Getting started - Doshii Dashboard](https://support.doshii.com/developer-support/getting-started-doshii-dashboard?hsLang=en)
- [Quick start for developers](https://support.doshii.com/developer-support/quick-start-for-developers?hsLang=en)
- [Onboarding](https://support.doshii.com/developer-support/onboarding?hsLang=en)
- [Location](https://support.doshii.com/developer-support/location?hsLang=en)
- [All App Partners Event](https://support.doshii.com/developer-support/all-app-partners-event?hsLang=en)
- [Menus](https://support.doshii.com/developer-support/menus?hsLang=en)
- [Loyalty / Checkins](https://support.doshii.com/developer-support/loyalty-checkins?hsLang=en)
- [WebSocket - App partners](https://support.doshii.com/developer-support/websocket-app-partners?hsLang=en)
- [All POS vendor events](https://support.doshii.com/developer-support/all-pos-vendor-events?hsLang=en)
- [Loyalty / Gift Cards](https://support.doshii.com/developer-support/loyalty-gift-cards?hsLang=en)
- [Devices](https://support.doshii.com/developer-support/devices?hsLang=en)
- [Tables](https://support.doshii.com/developer-support/tables?hsLang=en)
- [Workflows](https://support.doshii.com/developer-support/workflows?hsLang=en)
- [FAQ - Doshii Dashboard](https://support.doshii.com/developer-support/faq-doshii-dashboard?hsLang=en)
- [Bookings](https://support.doshii.com/developer-support/bookings?hsLang=en)
- [Transactions](https://support.doshii.com/developer-support/transactions?hsLang=en)
- [Webhooks](https://support.doshii.com/developer-support/webhooks?hsLang=en#main-content)

    - [App Partners](https://support.doshii.com/developer-support/webhooks?hsLang=en#app-partners)
    - [POS Vendors](https://support.doshii.com/developer-support/webhooks?hsLang=en#pos-vendors)
- [App Partner Guide](https://support.doshii.com/developer-support/app-partner-guide?hsLang=en)
- [Authentication](https://support.doshii.com/developer-support/authentication?hsLang=en)
- [Getting started - POS vendors](https://support.doshii.com/developer-support/getting-started-pos-vendors?hsLang=en)
- [Ordering](https://support.doshii.com/developer-support/ordering?hsLang=en)
- [Reservations](https://support.doshii.com/developer-support/reservations?hsLang=en)
- [Pilot](https://support.doshii.com/developer-support/pilot?hsLang=en)
- [Bulk data](https://support.doshii.com/developer-support/bulk-data?hsLang=en)
- [Playbooks](https://support.doshii.com/developer-support/playbooks?hsLang=en)
- [Rejection codes](https://support.doshii.com/developer-support/rejection-codes?hsLang=en)
- [Getting started](https://support.doshii.com/developer-support/getting-started?hsLang=en)
- [WebSocket - POS partners](https://support.doshii.com/developer-support/websocket-pos-partners?hsLang=en)
- [Events - App partners](https://support.doshii.com/developer-support/events-app-partners?hsLang=en)
- [Service channels](https://support.doshii.com/developer-support/service-channels?hsLang=en)
- [Events](https://support.doshii.com/developer-support/events?hsLang=en)
- [Concepts](https://support.doshii.com/developer-support/concepts?hsLang=en)
- [Apps](https://support.doshii.com/developer-support/apps?hsLang=en)

# Doshii Connect Pty Ltd

Doshii Connect Pty Ltd Help Center

Copyright © 2026, Doshii Connect Pty Ltd