Per-session quota utilization

GEThttps://myagentmail.com/linkedin/sessions/utilization

Returns each active LinkedIn session for the tenant with its action counts in the trailing 24 hours and the remaining daily budget per action type. Drives the "Today's utilization" panel in the dashboard and lets you decide when connecting another LinkedIn account would add headroom.

Sessions used: search_signal (recurring polls), search_history (one-shot lookups), profile_lookup (Pass-2 verification), connection_request, send_message, post_like.

Responses

200application/json

`ok` boolean
`budget` object	Per-action daily budget per session (the operator's safety cap).
`sessions` object[]
`sessionId` string
`label` string
`status` string
`rateLimitedUntil` string	format: date-time
`rateLimitReason` string
`counts` object	Action → count of calls in the trailing 24h. Keys: search_signal, search_history, profile_lookup, connection_request, send_message, post_like.
`remaining` object	Action → remaining daily budget for this session.

Authentication

Send your API key in the X-API-Key header (or Authorization: Bearer <key>). Any prefix accepted by this endpoint — tk_, wk_, ak_, or sa_ — is documented in the key prefix table.

Request

import { MyAgentMail } from "myagentmail";

const client = new MyAgentMail({ apiKey: process.env.MYAGENTMAIL_API_KEY! });

// GET /linkedin/sessions/utilization
const result = await client.request("get", "/linkedin/sessions/utilization");

Example response · 200

{
  "ok": false,
  "budget": {},
  "sessions": [
    {
      "sessionId": "string",
      "label": "string",
      "status": "string",
      "rateLimitedUntil": "2026-05-01T08:11:44.990Z",
      "rateLimitReason": "string",
      "counts": {},
      "remaining": {}
    }
  ]
}