Humanity Trades API
The Trades API from Humanity — 2 operation(s) for trades.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/humanity:humanity-trades-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
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 Specification
openapi: 3.2.0
info:
title: default Trades API
version: '2.0'
servers:
- url: https://www.humanity.com/api/v2
security:
- sec0: []
tags:
- name: Trades
paths:
/trades:
post:
summary: POST Trade
description: '/trades
Permission level: 5'
operationId: post-trade
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- tradewith
- reason
- shift
properties:
tradewith:
type: string
description: Array of employees ids (eg. "234,563,770")
reason:
type: string
shift:
type: integer
format: int32
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\": 1,\n \"data\": {\n \"id\": 1145258,\n \"status\": 0,\n \"user\": {\n \"id\": \"2\",\n \"name\": \"Ryan Fyfe\"\n },\n \"shift\": {\n \"id\": \"375872721\",\n \"created\": \"1485507472\",\n \"published\": \"0\",\n \"edited\": \"1485507472\",\n \"deleted\": \"0\",\n \"schedule\": \"66515\",\n \"type\": \"0\",\n \"needed\": \"0\",\n \"working\": \"1\",\n \"user\": \"2\",\n \"start_date\": {\n \"id\": 2830,\n \"month\": 1,\n \"day\": 27,\n \"wday\": 5,\n \"year\": 2017,\n \"weekday\": \"Fri\",\n \"mname\": \"Jan\",\n \"week\": 4,\n \"dayid\": 6,\n \"timeid\": 37,\n \"timeid_exact\": 37,\n \"formatted\": \"Jan 27, 2017\",\n \"iso8601\": \"2017-01-27T09:00:00-0500\",\n \"time\": \"09:00\",\n \"timestamp\": 1485525600,\n \"hours\": 9,\n \"minutes\": 0,\n \"seconds\": 0,\n \"date\": \"2017-01-27 09:00:00\",\n \"day_of_year\": \"26\",\n \"week_adjusted\": 4,\n \"sp_wday\": 6\n },\n \"end_date\": {\n \"id\": 2830,\n \"month\": 1,\n \"day\": 27,\n \"wday\": 5,\n \"year\": 2017,\n \"weekday\": \"Fri\",\n \"mname\": \"Jan\",\n \"week\": 4,\n \"dayid\": 6,\n \"timeid\": 69,\n \"timeid_exact\": 69,\n \"formatted\": \"Jan 27, 2017\",\n \"iso8601\": \"2017-01-27T17:00:00-0500\",\n \"time\": \"17:00\",\n \"timestamp\": 1485554400,\n \"hours\": 17,\n \"minutes\": 0,\n \"seconds\": 0,\n \"date\": \"2017-01-27 17:00:00\",\n \"day_of_year\": \"26\",\n \"week_adjusted\": 4,\n \"sp_wday\": 6\n },\n \"length\": 8,\n \"title\": \"\",\n \"location\": \"0\",\n \"notes\": \"\",\n \"confirmed\": \"0\",\n \"ref\": \"0\",\n \"start_timestamp\": \"2017-01-27 09:00:00\",\n \"end_timestamp\": \"2017-01-27 17:00:00\",\n \"perms\": \"2\",\n \"paidtime\": 8,\n \"start_time\": {\n \"id\": 37,\n \"time\": \"09:00\"\n },\n \"end_time\": {\n \"id\": 69,\n \"time\": \"17:00\"\n },\n \"schedule_name\": \"BOD\",\n \"schedule_color\": 1,\n \"employees\": [\n {\n \"id\": \"2\",\n \"name\": \"Ryan Fyfe\",\n \"avatar\": \"1346472359\",\n \"status\": \"1\",\n \"wage\": \"\",\n \"last_active\": \"1485507584\",\n \"rate\": \"\",\n \"ratecard\": \"0\",\n \"present\": \"0\",\n \"cost\": 0\n }\n ],\n \"employeesOnCall\": null,\n \"cost\": {\n \"staff\": 1,\n \"hours\": 8,\n \"dollars\": 0\n },\n \"repeats\": \"0\",\n \"staff\": null,\n \"break\": null,\n \"conflicts\": null,\n \"conflicts_types\": null,\n \"conflict_types\": null,\n \"requests\": null,\n \"trades\": [\n {\n \"trade_id\": \"1145258\",\n \"id\": \"2\",\n \"name\": \"Ryan Fyfe\"\n }\n ]\n },\n \"reason\": \"need day off\",\n \"date\": 1485507584,\n \"confirm_before\": 1,\n \"confirm_after\": 0,\n \"trade_to\": 0,\n \"swap\": 0,\n \"receivers\": [\n {\n \"user\": {\n \"id\": \"2500853\",\n \"name\": \"Rob Llewellyn\"\n },\n \"confirmed\": 0,\n \"approved\": 0\n }\n ]\n },\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: integer
example: 1
default: 0
data:
type: object
properties:
id:
type: integer
example: 1145258
default: 0
status:
type: integer
example: 0
default: 0
user:
type: object
properties:
id:
type: string
example: '2'
name:
type: string
example: Ryan Fyfe
shift:
type: object
properties:
id:
type: string
example: '375872721'
created:
type: string
example: '1485507472'
published:
type: string
example: '0'
edited:
type: string
example: '1485507472'
deleted:
type: string
example: '0'
schedule:
type: string
example: '66515'
type:
type: string
example: '0'
needed:
type: string
example: '0'
working:
type: string
example: '1'
user:
type: string
example: '2'
start_date:
type: object
properties:
id:
type: integer
example: 2830
default: 0
month:
type: integer
example: 1
default: 0
day:
type: integer
example: 27
default: 0
wday:
type: integer
example: 5
default: 0
year:
type: integer
example: 2017
default: 0
weekday:
type: string
example: Fri
mname:
type: string
example: Jan
week:
type: integer
example: 4
default: 0
dayid:
type: integer
example: 6
default: 0
timeid:
type: integer
example: 37
default: 0
timeid_exact:
type: integer
example: 37
default: 0
formatted:
type: string
example: Jan 27, 2017
iso8601:
type: string
example: 2017-01-27T09:00:00-0500
time:
type: string
example: 09:00
timestamp:
type: integer
example: 1485525600
default: 0
hours:
type: integer
example: 9
default: 0
minutes:
type: integer
example: 0
default: 0
seconds:
type: integer
example: 0
default: 0
date:
type: string
example: '2017-01-27 09:00:00'
day_of_year:
type: string
example: '26'
week_adjusted:
type: integer
example: 4
default: 0
sp_wday:
type: integer
example: 6
default: 0
end_date:
type: object
properties:
id:
type: integer
example: 2830
default: 0
month:
type: integer
example: 1
default: 0
day:
type: integer
example: 27
default: 0
wday:
type: integer
example: 5
default: 0
year:
type: integer
example: 2017
default: 0
weekday:
type: string
example: Fri
mname:
type: string
example: Jan
week:
type: integer
example: 4
default: 0
dayid:
type: integer
example: 6
default: 0
timeid:
type: integer
example: 69
default: 0
timeid_exact:
type: integer
example: 69
default: 0
formatted:
type: string
example: Jan 27, 2017
iso8601:
type: string
example: 2017-01-27T17:00:00-0500
time:
type: string
example: '17:00'
timestamp:
type: integer
example: 1485554400
default: 0
hours:
type: integer
example: 17
default: 0
minutes:
type: integer
example: 0
default: 0
seconds:
type: integer
example: 0
default: 0
date:
type: string
example: '2017-01-27 17:00:00'
day_of_year:
type: string
example: '26'
week_adjusted:
type: integer
example: 4
default: 0
sp_wday:
type: integer
example: 6
default: 0
length:
type: integer
example: 8
default: 0
title:
type: string
example: ''
location:
type: string
example: '0'
notes:
type: string
example: ''
confirmed:
type: string
example: '0'
ref:
type: string
example: '0'
start_timestamp:
type: string
example: '2017-01-27 09:00:00'
end_timestamp:
type: string
example: '2017-01-27 17:00:00'
perms:
type: string
example: '2'
paidtime:
type: integer
example: 8
default: 0
start_time:
type: object
properties:
id:
type: integer
example: 37
default: 0
time:
type: string
example: 09:00
end_time:
type: object
properties:
id:
type: integer
example: 69
default: 0
time:
type: string
example: '17:00'
schedule_name:
type: string
example: BOD
schedule_color:
type: integer
example: 1
default: 0
employees:
type: array
items:
type: object
properties:
id:
type: string
example: '2'
name:
type: string
example: Ryan Fyfe
avatar:
type: string
example: '1346472359'
status:
type: string
example: '1'
wage:
type: string
example: ''
last_active:
type: string
example: '1485507584'
rate:
type: string
example: ''
ratecard:
type: string
example: '0'
present:
type: string
example: '0'
cost:
type: integer
example: 0
default: 0
employeesOnCall: {}
cost:
type: object
properties:
staff:
type: integer
example: 1
default: 0
hours:
type: integer
example: 8
default: 0
dollars:
type: integer
example: 0
default: 0
repeats:
type: string
example: '0'
staff: {}
break: {}
conflicts: {}
conflicts_types: {}
conflict_types: {}
requests: {}
trades:
type: array
items:
type: object
properties:
trade_id:
type: string
example: '1145258'
id:
type: string
example: '2'
name:
type: string
example: Ryan Fyfe
reason:
type: string
example: need day off
date:
type: integer
example: 1485507584
default: 0
confirm_before:
type: integer
example: 1
default: 0
confirm_after:
type: integer
example: 0
default: 0
trade_to:
type: integer
example: 0
default: 0
swap:
type: integer
example: 0
default: 0
receivers:
type: array
items:
type: object
properties:
user:
type: object
properties:
id:
type: string
example: '2500853'
name:
type: string
example: Rob Llewellyn
confirmed:
type: integer
example: 0
default: 0
approved:
type: integer
example: 0
default: 0
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: http
code: https://www.humanity.com/api/v2/trades?access_token=xxxxxxx
samples-languages:
- http
tags:
- Trades
/trades/{trade}:
put:
summary: PUT Trade
description: '/trades/:trade
Permission level: 5'
operationId: put-trade
parameters:
- name: trade
in: path
required: true
schema:
type: integer
format: int32
requestBody:
content:
application/x-www-form-urlencoded:
schema:
type: object
required:
- action
properties:
action:
type: string
description: enum[activate,deactivade,cancel,accept,reject]
user:
type: integer
format: int32
responses:
'200':
description: '200'
content:
application/json:
examples:
Result:
value: "{\n \"status\":\"1\",\n \"data\":{\n \"id\":\"265\",\n \"status\":\"0\",\n \"user\":\"654\",\n \"shift\":\"97250\",\n \"store\":\"11\",\n \"reference\":\"\",\n \"reason\":\"No big reason\",\n \"date\":\"1339498178\",\n \"confirm_before\":\"0\",\n \"confirm_after\":\"0\",\n \"trade_to\":\"0\",\n \"shift_start_date\":{\n \"id\":\"1110\",\n \"month\":\"5\",\n \"day\":\"13\",\n \"year\":\"2012\",\n \"weekday\":\"Sun\",\n \"mname\":\"May\",\n \"week\":\"20\",\n \"dayid\":\"1\",\n \"formatted\":\"May 13, 2012\"\n },\n \"shift_start\":\"33\",\n \"shift_end\":\"73\",\n \"shift_schedule\":\"33499\",\n \"schedule_name\":\"Budget 1\",\n \"user_name\":\"Andy\",\n \"requested\":{\n \"id\":\"1110\",\n \"month\":\"5\",\n \"day\":\"13\",\n \"year\":\"2012\",\n \"weekday\":\"Sun\",\n \"mname\":\"May\",\n \"week\":\"20\",\n \"dayid\":\"1\",\n \"formatted\":\"May 13, 2012\"\n },\n \"shift_start_time\":\"8 am\",\n \"shift_end_time\":\"6 pm\",\n \"traders\":{\n \"count\":\"2\",\n \"data\":[\n {\n \"id\":\"2265\",\n \"trade_id\":\"245\",\n \"shift\":\"94220\",\n \"user\":\"5123\",\n \"confirmed\":\"0\",\n \"approved\":\"1\",\n \"sms\":\"0\",\n \"email\":\"0\",\n \"online\":\"0\",\n \"user_name\":\"Azra\"\n },\n {\n \"id\":\"2267\",\n \"trade_id\":\"245\",\n \"shift\":\"94220\",\n \"user\":\"5188\",\n \"confirmed\":\"0\",\n \"approved\":\"0\",\n \"sms\":\"0\",\n \"email\":\"0\",\n \"online\":\"0\",\n \"user_name\":\"Johny\"\n }\n ]\n }\n },\n \"error\": null\n}"
schema:
type: object
properties:
status:
type: string
example: '1'
data:
type: object
properties:
id:
type: string
example: '265'
status:
type: string
example: '0'
user:
type: string
example: '654'
shift:
type: string
example: '97250'
store:
type: string
example: '11'
reference:
type: string
example: ''
reason:
type: string
example: No big reason
date:
type: string
example: '1339498178'
confirm_before:
type: string
example: '0'
confirm_after:
type: string
example: '0'
trade_to:
type: string
example: '0'
shift_start_date:
type: object
properties:
id:
type: string
example: '1110'
month:
type: string
example: '5'
day:
type: string
example: '13'
year:
type: string
example: '2012'
weekday:
type: string
example: Sun
mname:
type: string
example: May
week:
type: string
example: '20'
dayid:
type: string
example: '1'
formatted:
type: string
example: May 13, 2012
shift_start:
type: string
example: '33'
shift_end:
type: string
example: '73'
shift_schedule:
type: string
example: '33499'
schedule_name:
type: string
example: Budget 1
user_name:
type: string
example: Andy
requested:
type: object
properties:
id:
type: string
example: '1110'
month:
type: string
example: '5'
day:
type: string
example: '13'
year:
type: string
example: '2012'
weekday:
type: string
example: Sun
mname:
type: string
example: May
week:
type: string
example: '20'
dayid:
type: string
example: '1'
formatted:
type: string
example: May 13, 2012
shift_start_time:
type: string
example: 8 am
shift_end_time:
type: string
example: 6 pm
traders:
type: object
properties:
count:
type: string
example: '2'
data:
type: array
items:
type: object
properties:
id:
type: string
example: '2265'
trade_id:
type: string
example: '245'
shift:
type: string
example: '94220'
user:
type: string
example: '5123'
confirmed:
type: string
example: '0'
approved:
type: string
example: '1'
sms:
type: string
example: '0'
email:
type: string
example: '0'
online:
type: string
example: '0'
user_name:
type: string
example: Azra
error: {}
'400':
description: '400'
content:
application/json:
examples:
Result:
value: '{}'
schema:
type: object
properties: {}
deprecated: false
x-readme:
code-samples:
- language: http
code: https://www.humanity.com/api/v2/trades/trades/265?access_token=xxxxx
samples-languages:
- http
tags:
- Trades
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
# --- truncated at 32 KB (45 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/humanity/refs/heads/main/openapi/humanity-trades-api-openapi.yml