relay-inbox

List Inbox Emails

List the authenticated user's synced inbound emails (gmail + relay), most recent first. Optionally filter by applicationResultId or jobListingId.

get/relay-inbox

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/relay-inbox
  • Auth: HTTP bearer

Query parameters

applicationResultIdinteger

Filter to emails linked to this application result row

Example:1234
boolean
OR
'0' | '1' | 'true' | 'false'
category'action_required' | 'application_confirmation' | 'assessment_request' | 'cancellation' | 'follow_up_request' | 'general' | 'interview_invite' | 'offer_letter' | 'outbound' | 'promotional' | 'recruiter_outreach' | 'rejection' | 'reschedule' | 'scheduling' | 'spam' | 'unrelated' | 'verification'

Filter to a single effective category (coalesce(override, signalType)). Allowlist-gated - a hidden category returns nothing.

Example:interview_invite
jobListingIdinteger

Filter to emails linked to this job listing row

Example:5678
limitinteger

Max rows to return (most recent first)

Example:50
offsetinteger nullable

Number of rows to skip (pagination), applied after filters/sort.

searchstring

Case-insensitive substring match across subject, sender name, sender email, and snippet.

Example:interview
sort'received_desc' | 'received_asc'

Sort order for the inbox feed by received time (newest or oldest first).

Example:received_desc
boolean
OR
'0' | '1' | 'true' | 'false'
boolean
OR
'0' | '1' | 'true' | 'false'

Response

Inbox emails retrieved

successtrue required

Example response

{
  "data": {
    "aliasEmail": "sarah-a1b2c3d@inboxquiet.com",
    "counts": {
      "unread": 3,
      "unreadEmployerOutcomes": 2
    },
    "items": [
      {
        "applicationResultId": 1234,
        "applicationStage": "interview",
        "categoryGroup": "interview",
        "companyName": "Acme",
        "effectiveSignalType": "interview_invite",
        "id": 9001,
        "jobListingId": 5678,
        "jobTitle": "Frontend Engineer",
        "senderEmail": "recruiter@acme.com",
        "senderName": "Alex Recruiter",
        "signalType": "interview_invite",
        "snippet": "Thanks for applying - we would love to schedule a call...",
        "source": "relay",
        "subject": "Your application to Acme"
      }
    ],
    "total": 42
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.