openapi: 3.0.3
info:
title: PushPress Platform ApiKeys Company API
description: 'The PushPress Platform API lets developers integrate with the PushPress gym and fitness business management platform. It exposes gym members (customers), check-ins (class, appointment, event, and open-facility), appointments, classes and class types, events, plan enrollments, membership plans, company details, staff/member invitations, transactional messaging (email, SMS, push, notifications), API key management, and platform webhook subscriptions for real-time events.
All requests are REST over HTTPS. Every request is authenticated with an API key passed in the `API-KEY` header, and is scoped to a single gym location (company) by the `company-id` header.
Endpoint PATHS and HTTP METHODS in this document are grounded in PushPress''s live public API reference and the official Speakeasy-generated PushPress SDK (`@pushpress/pushpress`, production server `https://api.pushpress.com/v3`). Request and response SCHEMAS are modeled by API Evangelist to a reasonable fidelity and should be verified against the authoritative PushPress OpenAPI before code generation.'
version: '3.0'
contact:
name: PushPress
url: https://www.pushpress.com
x-grounding:
pathsAndMethods: confirmed
schemas: modeled
sources:
- https://ppe.apidocumentation.com/
- https://github.com/PushPress/pushpress-ts
- https://www.npmjs.com/package/@pushpress/pushpress
servers:
- url: https://api.pushpress.com/v3
description: Production
- url: https://api.pushpressstage.com/v3
description: Staging
- url: https://api.pushpressdev.com/v3
description: Development
security:
- api_key: []
tags:
- name: Company
description: The gym / business (company) the API key is scoped to.
paths:
/company:
get:
operationId: getCompany
tags:
- Company
summary: Get company details
description: Retrieves details for the company (gym) the API key is scoped to.
responses:
'200':
description: The company.
content:
application/json:
schema:
$ref: '#/components/schemas/Company'
'401':
$ref: '#/components/responses/Unauthorized'
components:
responses:
Unauthorized:
description: Missing or invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
Error:
type: object
properties:
error:
type: object
properties:
code:
type: string
message:
type: string
Company:
type: object
properties:
id:
type: string
name:
type: string
email:
type: string
phone:
type: string
timezone:
type: string
address:
type: string
city:
type: string
state:
type: string
country:
type: string
securitySchemes:
api_key:
type: apiKey
in: header
name: API-KEY
description: API key issued in the PushPress developer portal, passed in the `API-KEY` request header. Requests are also scoped to a single gym location with a `company-id` header.