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

CharlieHR Company API

Company record, offices, and teams.

CharlieHR Company API is one of 4 APIs that CharlieHR publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Company. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 5 operations across 5 paths, and defines 6 schemas. It is described by OpenAPI 3.0.1, at version 1.0.

Requests are made against a single base URL, https://charliehr.com/api/v1.

5 operations 5 paths 6 schemas 5 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.1
API Version
1.0
Base URL
https://charliehr.com/api/v1
Authentication
OAuth 2.0
Terms of Service
Resource Areas
1

Authentication & Security 1

CharlieHR Company API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the clientCredentials flow. By default, every request must be authenticated.

  • oauth2 — OAuth 2.0. A Client ID and Client Secret issued in the CharlieHR app are exchanged for an access token, which is sent in the Authorization header of each reque…

Paths & Operations 5

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

Company 5

Company record, offices, and teams.

GET
/company
Get company
getCompany → 200401
GET
/offices
List offices
listOffices 2 params → 200401
GET
/offices/{id}
Get an office
getOffice 1 param → 200401404
GET
/teams
List teams
listTeams 2 params → 200401
GET
/teams/{id}
Get a team
getTeam 1 param → 200401404

Schemas 6

The contract defines 6 schemas that model the data the API accepts and returns. The most detailed are Error (3 properties), GenericList (3 properties), Pagination (3 properties), Company (3 properties). Each schema is shown below with its type and property counts.

GenericResponse
object
Generic single-object envelope used where the item schema is not fully published in CharlieHR's documentation.
2 properties
Company
object
The authenticated company record.
3 properties
Pagination
object
Pagination metadata returned with list responses.
3 properties
GenericList
object
Generic list envelope used where the per-item schema is not fully published in CharlieHR's documentation.
3 properties
CompanyResponse
object
2 properties
Error
object
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

charliehr-company-api-openapi.yml Raw ↑

Other APIs CharlieHR publishes across the network.

CharlieHR Leave / Absences API
CharlieHR Leave Allowances API
CharlieHR Team Members API