Humanity Sales API
The Sales API from Humanity — 1 operation(s) for sales.
The Sales API from Humanity — 1 operation(s) for sales.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/humanity:humanity-sales-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: default Sales API
version: '2.0'
servers:
- url: https://www.humanity.com/api/v2
security:
- sec0: []
tags:
- name: Sales
paths:
/sales/budget?access_token=xxxxx:
get:
summary: GET Budget
description: '/budget
Permission Level: 4'
operationId: get-budget
parameters:
- name: start_date
in: query
description: Start date
required: true
schema:
type: string
format: date
- name: end_date
in: query
description: End date
required: true
schema:
type: string
format: date
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\": 1,\n \"data\": [\n {\n \"id\": \"1297482\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3470,\n \"timestamp\": 1540767600,\n \"month\": 10,\n \"day\": 29,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 2,\n \"weekday\": \"Mon\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 29, 2018\"\n },\n \"end_date\": {\n \"id\": 3470,\n \"timestamp\": 1540767600,\n \"month\": 10,\n \"day\": 29,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 2,\n \"weekday\": \"Mon\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 29, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"12.00\",\n \"dollars\": \"120.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297483\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3471,\n \"timestamp\": 1540854000,\n \"month\": 10,\n \"day\": 30,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 3,\n \"weekday\": \"Tue\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 30, 2018\"\n },\n \"end_date\": {\n \"id\": 3471,\n \"timestamp\": 1540854000,\n \"month\": 10,\n \"day\": 30,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 3,\n \"weekday\": \"Tue\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 30, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"2.00\",\n \"dollars\": \"222.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297484\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3472,\n \"timestamp\": 1540940400,\n \"month\": 10,\n \"day\": 31,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 4,\n \"weekday\": \"Wed\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 31, 2018\"\n },\n \"end_date\": {\n \"id\": 3472,\n \"timestamp\": 1540940400,\n \"month\": 10,\n \"day\": 31,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 4,\n \"weekday\": \"Wed\",\n \"mname\": \"Oct\",\n \"formatted\": \"Oct 31, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"2.00\",\n \"dollars\": \"32.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297485\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3473,\n \"timestamp\": 1541026800,\n \"month\": 11,\n \"day\": 1,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 5,\n \"weekday\": \"Thu\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 1, 2018\"\n },\n \"end_date\": {\n \"id\": 3473,\n \"timestamp\": 1541026800,\n \"month\": 11,\n \"day\": 1,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 5,\n \"weekday\": \"Thu\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 1, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"2.00\",\n \"dollars\": \"12.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297486\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3474,\n \"timestamp\": 1541113200,\n \"month\": 11,\n \"day\": 2,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 6,\n \"weekday\": \"Fri\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 2, 2018\"\n },\n \"end_date\": {\n \"id\": 3474,\n \"timestamp\": 1541113200,\n \"month\": 11,\n \"day\": 2,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 6,\n \"weekday\": \"Fri\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 2, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"2.00\",\n \"dollars\": \"12.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297487\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3475,\n \"timestamp\": 1541199600,\n \"month\": 11,\n \"day\": 3,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 7,\n \"weekday\": \"Sat\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 3, 2018\"\n },\n \"end_date\": {\n \"id\": 3475,\n \"timestamp\": 1541199600,\n \"month\": 11,\n \"day\": 3,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 7,\n \"weekday\": \"Sat\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 3, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"3.00\",\n \"dollars\": \"12.00\",\n \"position\": \"0\"\n },\n {\n \"id\": \"1297488\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3476,\n \"timestamp\": 1541286000,\n \"month\": 11,\n \"day\": 4,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 1,\n \"weekday\": \"Sun\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 4, 2018\"\n },\n \"end_date\": {\n \"id\": 3476,\n \"timestamp\": 1541286000,\n \"month\": 11,\n \"day\": 4,\n \"year\": 2018,\n \"week\": 44,\n \"dayid\": 1,\n \"weekday\": \"Sun\",\n \"mname\": \"Nov\",\n \"formatted\": \"Nov 4, 2018\"\n },\n \"location\": \"0\",\n \"hours\": \"12.00\",\n \"dollars\": \"12.00\",\n \"position\": \"0\"\n }\n ],\n \"metadata\": [],\n \"token\": \"xxxxxxxxxxx\",\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: integer
example: 1
default: 0
data:
type: array
items:
type: object
properties:
id:
type: string
example: '1297482'
store:
type: string
example: '303579'
start_date:
type: object
properties:
id:
type: integer
example: 3470
default: 0
timestamp:
type: integer
example: 1540767600
default: 0
month:
type: integer
example: 10
default: 0
day:
type: integer
example: 29
default: 0
year:
type: integer
example: 2018
default: 0
week:
type: integer
example: 44
default: 0
dayid:
type: integer
example: 2
default: 0
weekday:
type: string
example: Mon
mname:
type: string
example: Oct
formatted:
type: string
example: Oct 29, 2018
end_date:
type: object
properties:
id:
type: integer
example: 3470
default: 0
timestamp:
type: integer
example: 1540767600
default: 0
month:
type: integer
example: 10
default: 0
day:
type: integer
example: 29
default: 0
year:
type: integer
example: 2018
default: 0
week:
type: integer
example: 44
default: 0
dayid:
type: integer
example: 2
default: 0
weekday:
type: string
example: Mon
mname:
type: string
example: Oct
formatted:
type: string
example: Oct 29, 2018
location:
type: string
example: '0'
hours:
type: string
example: '12.00'
dollars:
type: string
example: '120.00'
position:
type: string
example: '0'
metadata:
type: array
token:
type: string
example: xxxxxxxxxxx
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: html
code: https://www.humanity.com/api/v2/sales/budget?access_token=xxxxxxx&start_date=2018-10-29&end_date=2018-11-04
samples-languages:
- html
tags:
- Sales
post:
summary: POST Budget
description: '/budget
Permission Level: 4'
operationId: post-budget
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
properties:
start_date:
type: string
description: Start date of the budget that we want to add
format: date
end_date:
type: string
description: End date of the budget that we want to add
format: date
hours:
type: integer
description: Hours
format: int32
Dollars:
type: integer
description: Amount of dollars for the given hours
format: int32
Location:
type: integer
description: Location ID for which we want to create a budget
format: int32
Position:
type: integer
description: Position ID for which we want to create a budget
format: int32
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\": 1,\n \"data\": {\n \"id\": \"976065\",\n \"store\": \"303579\",\n \"start_date\": {\n \"id\": 3226,\n \"timestamp\": 1519686000,\n \"month\": 2,\n \"day\": 27,\n \"year\": 2018,\n \"week\": 9,\n \"dayid\": 3,\n \"weekday\": \"Tue\",\n \"mname\": \"Feb\",\n \"formatted\": \"Feb 27, 2018\"\n },\n \"end_date\": {\n \"id\": 3226,\n \"timestamp\": 1519686000,\n \"month\": 2,\n \"day\": 27,\n \"year\": 2018,\n \"week\": 9,\n \"dayid\": 3,\n \"weekday\": \"Tue\",\n \"mname\": \"Feb\",\n \"formatted\": \"Feb 27, 2018\"\n },\n \"location\": \"667179\",\n \"hours\": \"3333\",\n \"dollars\": \"33333\",\n \"position\": \"\"\n },\n \"token\": \"xxxxxxxxxxxx\",\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: integer
example: 1
default: 0
data:
type: object
properties:
id:
type: string
example: '976065'
store:
type: string
example: '303579'
start_date:
type: object
properties:
id:
type: integer
example: 3226
default: 0
timestamp:
type: integer
example: 1519686000
default: 0
month:
type: integer
example: 2
default: 0
day:
type: integer
example: 27
default: 0
year:
type: integer
example: 2018
default: 0
week:
type: integer
example: 9
default: 0
dayid:
type: integer
example: 3
default: 0
weekday:
type: string
example: Tue
mname:
type: string
example: Feb
formatted:
type: string
example: Feb 27, 2018
end_date:
type: object
properties:
id:
type: integer
example: 3226
default: 0
timestamp:
type: integer
example: 1519686000
default: 0
month:
type: integer
example: 2
default: 0
day:
type: integer
example: 27
default: 0
year:
type: integer
example: 2018
default: 0
week:
type: integer
example: 9
default: 0
dayid:
type: integer
example: 3
default: 0
weekday:
type: string
example: Tue
mname:
type: string
example: Feb
formatted:
type: string
example: Feb 27, 2018
location:
type: string
example: '667179'
hours:
type: string
example: '3333'
dollars:
type: string
example: '33333'
position:
type: string
example: ''
token:
type: string
example: xxxxxxxxxxxx
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: html
code: https://www.humanity.com/api/v2/sales/budget?access_token=xxxxxxxxx
samples-languages:
- html
tags:
- Sales
components:
securitySchemes:
sec0:
x-default: ''
type: apiKey
name: access_token
in: query
x-readme-fauxas: true
x-provenance:
method: searched
source: https://platform.humanity.com/reference
harvested: '2026-10-14'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://platform.humanity.com/reference/approve-availability.md
- https://platform.humanity.com/reference/approve-series.md
- https://platform.humanity.com/reference/create-availability-series.md
- https://platform.humanity.com/reference/create-datapoints.md
- https://platform.humanity.com/reference/create-driver.md
- https://platform.humanity.com/reference/create-master-tasks.md
- https://platform.humanity.com/reference/create-single-availability.md
- https://platform.humanity.com/reference/create-skill-expiration-data.md
- https://platform.humanity.com/reference/delete-availability.md
- https://platform.humanity.com/reference/delete-custom-field.md
- https://platform.humanity.com/reference/delete-datapoint.md
- https://platform.humanity.com/reference/delete-driver.md
- https://platform.humanity.com/reference/delete-employee-position.md
- https://platform.humanity.com/reference/delete-employee.md
- https://platform.humanity.com/reference/delete-forecastdatatype-by-unique_id.md
- https://platform.humanity.com/reference/delete-forecastdatatypes.md
- https://platform.humanity.com/reference/delete-future-availability.md
- https://platform.humanity.com/reference/delete-leave-type.md
- https://platform.humanity.com/reference/delete-leave.md
- https://platform.humanity.com/reference/delete-location.md
- https://platform.humanity.com/reference/delete-master-tasks.md
- https://platform.humanity.com/reference/delete-message.md
- https://platform.humanity.com/reference/delete-note.md
- https://platform.humanity.com/reference/delete-nottice.md
- https://platform.humanity.com/reference/delete-position-break-rules.md
- https://platform.humanity.com/reference/delete-position.md
- https://platform.humanity.com/reference/delete-ratecards.md
- https://platform.humanity.com/reference/delete-shift-breaks.md
- https://platform.humanity.com/reference/delete-shift.md
- https://platform.humanity.com/reference/delete-shifts-approve.md
- https://platform.humanity.com/reference/delete-skill.md
- https://platform.humanity.com/reference/delete-timeclock-event.md
- https://platform.humanity.com/reference/delete-timeclock-location.md
- https://platform.humanity.com/reference/delete-timeclock-terminal.md
- https://platform.humanity.com/reference/delete-timeclock.md
- https://platform.humanity.com/reference/delete-training-module.md
- https://platform.humanity.com/reference/delete-training-section.md
- https://platform.humanity.com/reference/delete-wall-message.md
- https://platform.humanity.com/reference/delete-weekly-availability.md
- https://platform.humanity.com/reference/get-availability-approve.md
- https://platform.humanity.com/reference/get-availability-by-series.md
- https://platform.humanity.com/reference/get-availability-in-date-period.md
- https://platform.humanity.com/reference/get-billing-packages.md
- https://platform.humanity.com/reference/get-budget.md
- https://platform.humanity.com/reference/get-business.md
- https://platform.humanity.com/reference/get-clear.md
- https://platform.humanity.com/reference/get-companies.md
- https://platform.humanity.com/reference/get-company-settings.md
- https://platform.humanity.com/reference/get-company.md
- https://platform.humanity.com/reference/get-custom-field.md
- https://platform.humanity.com/reference/get-custom-fields.md
- https://platform.humanity.com/reference/get-custom-report.md
- https://platform.humanity.com/reference/get-daily-peak-hours-report.md
- https://platform.humanity.com/reference/get-data-points.md
- https://platform.humanity.com/reference/get-datapoint-by-datapoints-unique-id.md
- https://platform.humanity.com/reference/get-datapoint.md
- https://platform.humanity.com/reference/get-datapoints.md
- https://platform.humanity.com/reference/get-driver.md
- https://platform.humanity.com/reference/get-drivers-from-company.md
- https://platform.humanity.com/reference/get-employee-by-eid.md
- https://platform.humanity.com/reference/get-employee-by-employee-id-copy.md
- https://platform.humanity.com/reference/get-employee-manage-positions.md
- https://platform.humanity.com/reference/get-employee-position.md
- https://platform.humanity.com/reference/get-employee-report.md
- https://platform.humanity.com/reference/get-employee-tasks.md
- https://platform.humanity.com/reference/get-employee.md
- https://platform.humanity.com/reference/get-employees-positions.md
- https://platform.humanity.com/reference/get-employees-preclockin.md
- https://platform.humanity.com/reference/get-employees.md
- https://platform.humanity.com/reference/get-forecast-datatypes.md
- https://platform.humanity.com/reference/get-forecastdatatype-by-unique_id.md
- https://platform.humanity.com/reference/get-forecastdatatype.md
- https://platform.humanity.com/reference/get-future-availability.md
- https://platform.humanity.com/reference/get-group-permisions.md
- https://platform.humanity.com/reference/get-group-reports.md
- https://platform.humanity.com/reference/get-leave-types-1.md
- https://platform.humanity.com/reference/get-leave-types-for-a-specific-employee.md
- https://platform.humanity.com/reference/get-leave.md
- https://platform.humanity.com/reference/get-leaves.md
- https://platform.humanity.com/reference/get-location.md
- https://platform.humanity.com/reference/get-locations.md
- https://platform.humanity.com/reference/get-master-tasks.md
- https://platform.humanity.com/reference/get-me.md
- https://platform.humanity.com/reference/get-message.md
- https://platform.humanity.com/reference/get-messages.md
- https://platform.humanity.com/reference/get-multiple.md
- https://platform.humanity.com/reference/get-note.md
- https://platform.humanity.com/reference/get-notes.md
- https://platform.humanity.com/reference/get-notices.md
- https://platform.humanity.com/reference/get-nottice.md
- https://platform.humanity.com/reference/get-number-of-requests.md
- https://platform.humanity.com/reference/get-onnow.md
- https://platform.humanity.com/reference/get-payroll-report.md
- https://platform.humanity.com/reference/get-position-breakrules.md
- https://platform.humanity.com/reference/get-position.md
- https://platform.humanity.com/reference/get-positions.md
- https://platform.humanity.com/reference/get-preclockins.md
- https://platform.humanity.com/reference/get-publish.md
- https://platform.humanity.com/reference/get-ratecard.md
- https://platform.humanity.com/reference/get-ratecards.md
- https://platform.humanity.com/reference/get-schedule-report.md
- https://platform.humanity.com/reference/get-shift-breaks.md
- https://platform.humanity.com/reference/get-shift-tasks.md
- https://platform.humanity.com/reference/get-shift.md
- https://platform.humanity.com/reference/get-shifts-approve.md
- https://platform.humanity.com/reference/get-shifts.md
- https://platform.humanity.com/reference/get-single-availability-slot.md
- https://platform.humanity.com/reference/get-skill.md
- https://platform.humanity.com/reference/get-skills.md
- https://platform.humanity.com/reference/get-swap.md
- https://platform.humanity.com/reference/get-timeclock-event.md
- https://platform.humanity.com/reference/get-timeclock-location.md
- https://platform.humanity.com/reference/get-timeclock-status.md
- https://platform.humanity.com/reference/get-timeclock-terminal.md
- https://platform.humanity.com/reference/get-timeclock.md
- https://platform.humanity.com/reference/get-timeclocks-terminal.md
- https://platform.humanity.com/reference/get-timeclocks.md
- https://platform.humanity.com/reference/get-timesheets-report.md
- https://platform.humanity.com/reference/get-trade.md
- https://platform.humanity.com/reference/get-trades.md
- https://platform.humanity.com/reference/get-training-module-comments.md
- https://platform.humanity.com/reference/get-training-module-signature.md
- https://platform.humanity.com/reference/get-training-module.md
- https://platform.humanity.com/reference/get-training-modules.md
- https://platform.humanity.com/reference/get-training-progress.md
- https://platform.humanity.com/reference/get-training-section.md
- https://platform.humanity.com/reference/get-training-sections.md
- https://platform.humanity.com/reference/get-wall-messages.md
- https://platform.humanity.com/reference/get-weekly-availability.md
- https://platform.humanity.com/reference/get-workunits-daily-report.md
- https://platform.humanity.com/reference/post-add-clock-time.md
- https://platform.humanity.com/reference/post-availability-approve.md
- https://platform.humanity.com/reference/post-budget.md
- https://platform.humanity.com/reference/post-copy-datapoints-by-datatype-unique-id.md
- https://platform.humanity.com/reference/post-copy-datapoints.md
- https://platform.humanity.com/reference/post-custom-fields.md
- https://platform.humanity.com/reference/post-datapoint.md
- https://platform.humanity.com/reference/post-employee-clockin.md
- https://platform.humanity.com/reference/post-employee-manage-positions.md
- https://platform.humanity.com/reference/post-employee-position.md
- https://platform.humanity.com/reference/post-employee.md
- https://platform.humanity.com/reference/post-employees-preclockin.md
- https://platform.humanity.com/reference/post-forecastdatatypes.md
- https://platform.humanity.com/reference/post-future-availability.md
- https://platform.humanity.com/reference/post-leave-request-all-day.md
- https://platform.humanity.com/reference/post-leave-request-hourly.md
- https://platform.humanity.com/reference/post-leave-types.md
- https://platform.humanity.com/reference/post-location.md
- https://platform.humanity.com/reference/post-message.md
- https://platform.humanity.com/reference/post-note.md
- https://platform.humanity.com/reference/post-nottice.md
- https://platform.humanity.com/reference/post-position-break-rules.md
- https://platform.humanity.com/reference/post-position.md
- https://platform.humanity.com/reference/post-save-note.md
- https://platform.humanity.com/reference/post-shift-breaks.md
- https://platform.humanity.com/reference/post-shift.md
- https://platform.humanity.com/reference/post-shifts-approve.md
- https://platform.humanity.com/reference/post-skills.md
- https://platform.humanity.com/reference/post-timeclock-event.md
- https://platform.humanity.com/reference/post-timeclock-location.md
- https://platform.humanity.com/reference/post-timeclock-terminal-clockout.md
- https://platform.humanity.com/reference/post-timeclock-terminal-login.md
- https://platform.humanity.com/reference/post-timeclock-terminal.md
- https://platform.humanity.com/reference/post-timeclocks.md
- https://platform.humanity.com/reference/post-trade.md
- https://platform.humanity.com/reference/post-training-modules.md
- https://platform.humanity.com/reference/post-training-section.md
- https://platform.humanity.com/reference/post-wall-message.md
- https://platform.humanity.com/reference/put-approving-leave-request.md
- https://platform.humanity.com/reference/put-availability-approve.md
- https://platform.humanity.com/reference/put-company-settings.md
- https://platform.humanity.com/reference/put-custom-fields.md
- https://platform.humanity.com/reference/put-datapoint-by-the-datatype-unique-id.md
- https://platform.humanity.com/reference/put-datapoint.md
- https://platform.humanity.com/reference/put-employee-clockout.md
- https://platform.humanity.com/reference/put-employee-position.md
- https://platform.humanity.com/reference/put-employee.md
- https://platform.humanity.com/reference/put-enablingdisabling-leave-types-for-employees.md
- https://platform.humanity.com/reference/put-forecastdatatypes-by-unique-id-copy.md
# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/humanity/refs/heads/main/openapi/humanity-sales-api-openapi.yml