Phorest

Phorest Branches API

Branches (locations), rooms, machines, and tax rates.

GitHub OpenAPI

Operations 8

GET /{businessId}/branch List branches #
GET /{businessId}/branch/{branchId}/worktimetable Retrieve a branch's work time table #
GET /{businessId}/branch/{branchId}/room List treatment rooms #
GET /{businessId}/branch/{branchId}/room/{roomId} Retrieve a treatment room #
GET /{businessId}/branch/{branchId}/machine List machines #
GET /{businessId}/branch/{branchId}/machine/{machineId} Retrieve a machine #
GET /{businessId}/branch/{branchId}/taxrate List tax rates #
GET /{businessId}/branch/{branchId}/taxrate/{taxRateId} Retrieve a tax rate #

Documentation

📖
Documentation
https://developer.phorest.com/docs/using-the-client-endpoint
📖
APIReference
https://developer.phorest.com/reference/getclients
📖
Documentation
https://developer.phorest.com/docs/common-api-use-cases
📖
APIReference
https://developer.phorest.com/reference/getappointments
📖
Documentation
https://developer.phorest.com/docs/list-of-errors-seen-on-appointments-bookings-endpoints
📖
APIReference
https://developer.phorest.com/reference/getstafflist
📖
APIReference
https://developer.phorest.com/reference/getstaffworktimetables
📖
APIReference
https://developer.phorest.com/reference/getservices_1
📖
APIReference
https://developer.phorest.com/reference/getservicecategories
📖
Documentation
https://support.phorest.com/hc/en-us/articles/360018547979-Integrating-3rd-Party-E-Commerce-Solutions
📖
APIReference
https://developer.phorest.com/reference/createpurchase
📖
APIReference
https://developer.phorest.com/reference/getproducts
📖
APIReference
https://developer.phorest.com/reference/getvouchers
📖
APIReference
https://developer.phorest.com/reference/createvoucher
📖
APIReference
https://developer.phorest.com/reference/getbranches
📖
APIReference
https://developer.phorest.com/reference/getbranchworktimetable
📖
APIReference
https://developer.phorest.com/reference/createcsvexportjob
📖
APIReference
https://developer.phorest.com/reference/getreviewlist

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/phorest/refs/heads/main/openapi/phorest-branches-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/phorest-branches-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

phorest-branches-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Phorest Third-Party Appointments Branches API
  description: The Phorest API exposes a partner-gated business's salon/spa data - clients, appointments, bookings, staff, services, products, purchases, vouchers, loyalty, and reporting - for approved integrators. Access is granted by Phorest support on request (quoting a Phorest Account Number), not through self-service signup. Requests use HTTP Basic authentication with a `global/{email}` username and a Phorest-issued API password, and are scoped in the URL path to a `businessId` and, for most resources, a `branchId`. Endpoints, methods, and parameters in this document are transcribed from Phorest's public API reference at developer.phorest.com/reference; a small number of item-level paths (marked in their description) are modeled by convention from the confirmed collection-level siblings because Phorest's public reference does not expose every single-resource path in plain text.
  version: '1.0'
  contact:
    name: Phorest API Support
    email: api-requests@phorest.com
    url: https://developer.phorest.com/docs/getting-started
  license:
    name: Proprietary - partner access only
    url: https://developer.phorest.com/docs/requesting-assistance-with-the-phorest-api
servers:
- url: https://api-gateway-eu.phorest.com/third-party-api-server/api/business
  description: EU production gateway
- url: https://api-gateway-us.phorest.com/third-party-api-server/api/business
  description: US/AUS production gateway
- url: https://platform.phorest.com/third-party-api-server/api/business
  description: EU production alias documented in Phorest support articles
security:
- basicAuth: []
tags:
- name: Branches
  description: Branches (locations), rooms, machines, and tax rates.
paths:
  /{businessId}/branch:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    get:
      operationId: getBranches
      tags:
      - Branches
      summary: List branches
      description: 'Lists a business''s branches (locations). Confirmed: developer.phorest.com/reference/getbranches.'
      parameters:
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: Branches listed successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Branch'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/RateLimited'
        '500':
          $ref: '#/components/responses/ServerError'
  /{businessId}/branch/{branchId}/worktimetable:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    get:
      operationId: getBranchWorkTimeTable
      tags:
      - Branches
      summary: Retrieve a branch's work time table
      description: 'Returns the branch''s opening hours / work-time table. Confirmed to exist: developer.phorest.com/reference/getbranchworktimetable; sub-path modeled by convention.'
      responses:
        '200':
          description: Branch work time table.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BranchWorkTimeTable'
  /{businessId}/branch/{branchId}/room:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    get:
      operationId: getRooms
      tags:
      - Branches
      summary: List treatment rooms
      description: 'Lists treatment rooms for a branch, filterable by update date and archived status. Confirmed: developer.phorest.com/reference/getrooms.'
      parameters:
      - name: updated_from
        in: query
        schema:
          type: string
          format: date-time
      - name: includeArchived
        in: query
        schema:
          type: boolean
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: Rooms listed successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Room'
  /{businessId}/branch/{branchId}/room/{roomId}:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    - name: roomId
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: getRoom
      tags:
      - Branches
      summary: Retrieve a treatment room
      description: 'Retrieves a single room by ID. Confirmed to exist: developer.phorest.com/reference/getroom; sub-path modeled by convention.'
      responses:
        '200':
          description: The requested room.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Room'
        '404':
          $ref: '#/components/responses/NotFound'
  /{businessId}/branch/{branchId}/machine:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    get:
      operationId: getMachines
      tags:
      - Branches
      summary: List machines
      description: 'Lists equipment/machines for a branch, filterable by update date and archived status. Confirmed: developer.phorest.com/reference/getmachines.'
      parameters:
      - name: updated_from
        in: query
        schema:
          type: string
          format: date-time
      - name: includeArchived
        in: query
        schema:
          type: boolean
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: Machines listed successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Machine'
  /{businessId}/branch/{branchId}/machine/{machineId}:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    - name: machineId
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: getMachine
      tags:
      - Branches
      summary: Retrieve a machine
      description: 'Retrieves a single machine by ID. Confirmed to exist: developer.phorest.com/reference/getmachine; sub-path modeled by convention.'
      responses:
        '200':
          description: The requested machine.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Machine'
        '404':
          $ref: '#/components/responses/NotFound'
  /{businessId}/branch/{branchId}/taxrate:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    get:
      operationId: getTaxRates
      tags:
      - Branches
      summary: List tax rates
      description: 'Lists tax rates configured for a branch. Confirmed: developer.phorest.com/reference/gettaxrates.'
      parameters:
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Page'
      responses:
        '200':
          description: Tax rates listed successfully.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/TaxRate'
  /{businessId}/branch/{branchId}/taxrate/{taxRateId}:
    parameters:
    - $ref: '#/components/parameters/BusinessId'
    - $ref: '#/components/parameters/BranchId'
    - name: taxRateId
      in: path
      required: true
      schema:
        type: string
    get:
      operationId: getTaxRate
      tags:
      - Branches
      summary: Retrieve a tax rate
      description: 'Retrieves a single tax rate by ID. Confirmed to exist: developer.phorest.com/reference/gettaxrate; sub-path modeled by convention.'
      responses:
        '200':
          description: The requested tax rate.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TaxRate'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  responses:
    RateLimited:
      description: Request rate limit exceeded. Current limit set to 100 requests per second.
    NotFound:
      description: The specified business, branch, or resource does not exist.
    ServerError:
      description: Internal server error.
    BadRequest:
      description: The request was invalid.
  schemas:
    Branch:
      type: object
      properties:
        branchId:
          type: string
        name:
          type: string
        address:
          type: string
        phone:
          type: string
        timezone:
          type: string
    TaxRate:
      type: object
      properties:
        taxRateId:
          type: string
        name:
          type: string
        rate:
          type: number
    BranchWorkTimeTable:
      type: object
      properties:
        branchId:
          type: string
        openingHours:
          type: array
          items:
            type: object
            properties:
              dayOfWeek:
                type: string
              startTime:
                type: string
              endTime:
                type: string
    Room:
      type: object
      properties:
        roomId:
          type: string
        name:
          type: string
        archived:
          type: boolean
    Machine:
      type: object
      properties:
        machineId:
          type: string
        name:
          type: string
        archived:
          type: boolean
  parameters:
    Page:
      name: page
      in: query
      description: Zero-indexed page number. Defaults to 0.
      schema:
        type: integer
        default: 0
        minimum: 0
    BranchId:
      name: branchId
      in: path
      required: true
      description: The Phorest branch (location) identifier.
      schema:
        type: string
    BusinessId:
      name: businessId
      in: path
      required: true
      description: The Phorest business (salon group) identifier.
      schema:
        type: string
    Size:
      name: size
      in: query
      description: Records per page. Max 100, defaults to 20.
      schema:
        type: integer
        default: 20
        maximum: 100
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: Username is `global/{email}`, using the email address Phorest associated with the granted API access. Password is the API password issued by Phorest support.