Application mail
GET /me/inbox Session or API key
List your mail, newest first, excluding deleted.
?body=1 returns each message's readable text inline and marks nothing read — that is the agent read path, so sweeping a backlog never zeroes the owner's unread count (GET /me/emails/{id} does mark read). Pages carrying bodies are capped at 50. An unknown source, status or link value is a 400, never a silently empty page.
Query parameters
sourcestring- One account:
gmail,hosted, orexternal. statusstring- One classified label (see the triage vocabulary below).Example
rejection unclassifiedboolean- Only mail nothing has judged yet — the agent's work queue.
unreadboolean- Only messages you have not opened.
linkstring- One link state:
linked,suggested(awaiting your word), orunlinked. qstring- Match subject, sender, or body.
bodyboolean- Include each message body; caps the page at 50.
limitinteger- Page size.
offsetinteger- Page offset.
curl "https://freehire.me/api/v1/me/inbox?unclassified=1&body=1&limit=50" \
-H "Authorization: Bearer fhk_…"{
"data": [
{
"id": 4821,
"source": "gmail",
"external_id": "<CAF...@mail.gmail.com>",
"from_addr": "no-reply@us.greenhouse-mail.io",
"from_name": "Speechify Recruiting",
"subject": "Thank you for applying to Speechify",
"snippet": "We have received your application…",
"received_at": "2026-07-24T09:12:00Z",
"read": false,
"status_signal": "acknowledgement",
"link_source": "thread",
"linked_slug": "tech-lead-web-core-speechify-a1b2"
}
],
"meta": { "total": 137, "limit": 50, "offset": 0 }
}