openapi: 3.2.0
info:
title: Harri Employee Open Franchisee Location API
description: 'API for managing and retrieving employee data in the Harri system. - Notice: Harri''s API enforces a rate limit of 400 requests per minute. Once you exceed this limit, an HTTP 403 error is returned with a body that informs you that the limit has been exceeded. Please examine the API returns for this error so your software can respond appropriately. After 4 June, 2026, the rate limiting error will change from 403 to 429.'
termsOfService: https://harri.com/terms
version: 1.0.0
servers:
- url: https://gateway.harri.com/open-api-hub
tags:
- name: Franchisee Location
paths:
/api/v1/franchisees/{franchiseeId}/locations:
get:
tags:
- Franchisee Location
summary: Retrieve all locations API
description: Retrieve all locations
operationId: FranshiseesGetAllLocations
parameters:
- name: franchiseeId
in: path
required: true
schema:
type: number
responses:
'200':
description: successful operation
content:
application/json:
schema:
type: array
items:
allOf:
- $ref: '#/components/schemas/Location'
- type: object
properties:
type:
type: string
components:
schemas:
Location:
type: object
properties:
id:
type: number
name:
type: string
country_code:
type: string
state_code:
type: string
city:
type: string
securitySchemes:
oAuth2ClientCredentials:
type: oauth2
flows:
clientCredentials:
tokenUrl: https://oauth.harri.com/oauth2/token
scopes: {}