Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

7shifts Time Off API

Time off requests and approvals.

7shifts Time Off API is one of 15 APIs that 7shifts publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Time Off. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, a getting-started guide, rate-limit docs, and a changelog.

This API exposes 3 operations across 2 paths, and defines 2 schemas. It is described by OpenAPI 3.1.0, at version 2.0.

Requests are made against a single base URL, https://api.7shifts.com.

3 operations 2 paths 2 schemas 1 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
2.0
Base URL
https://api.7shifts.com/v2
Authentication
HTTP Bearer, OAuth 2.0
Resource Areas
1

Authentication & Security 2

7shifts Time Off API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It supports OAuth 2.0 (oauth2) using the clientCredentials flow.

  • bearerAuth — Access token obtained from /oauth2/token passed as a Bearer token.
  • oauth2 — OAuth 2.0 with clientcredentials, password, authorizationcode, and refreshtoken grant types.

Paths & Operations 3

Across 2 paths, the API surfaces 3 operations — 1 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Time Off 3

Time off requests and approvals.

GET
/v2/company/{company_id}/time_off
List Time Off
listTimeOff 5 params → 200
POST
/v2/company/{company_id}/time_off
Create Time Off
createTimeOff 1 param body → 201
POST
/v2/company/{company_id}/time_off/{time_off_id}/approve
Approve Time Off Request
approveTimeOff 2 params → 200404

Schemas 2

The contract defines 2 schemas that model the data the API accepts and returns. The most detailed are TimeOff (10 properties), CursorMeta (2 properties). Each schema is shown below with its type and property counts.

CursorMeta
object
Cursor-based pagination metadata.
2 properties
TimeOff
object
10 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

7shifts-time-off-api-openapi.yml Raw ↑

Other APIs 7shifts publishes across the network.

7shifts Availability API
7shifts Companies API
7shifts Departments API
7shifts Identity API
7shifts Locations API
7shifts OAuth API
7shifts Reporting API
7shifts Roles API
7shifts Sales API
7shifts Shifts API
7shifts Time Punches API
7shifts Users API