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 Punches API

Clock-in and clock-out time tracking records.

7shifts Time Punches 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 Punches. 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 3 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 3 schemas 2 GET1 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 Punches 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 — 2 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Time Punches 3

Clock-in and clock-out time tracking records.

GET
/v2/company/{company_id}/time_punches
List Time Punches
listTimePunches 10 params → 200
POST
/v2/company/{company_id}/time_punches
Create Time Punch
createTimePunch 1 param body → 201
GET
/v2/company/{company_id}/time_punches/{time_punch_id}
Retrieve Time Punch
retrieveTimePunch 2 params → 200404

Schemas 3

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

Break
object
4 properties
CursorMeta
object
Cursor-based pagination metadata.
2 properties
TimePunch
object
15 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

7shifts-time-punches-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 Off API
7shifts Users API