Read tools
Tools that read your senders, inbox, actions and stats. Most answer from SendCrew's own data. `get_profile` may queue a profile view, which counts against the sender's view cap.
get_profile
GET /api/v1/profile · read
Look up a LinkedIn profile by URL. Returns the stored profile if fresh; otherwise queues a profile view (counted against the sender's view cap) and returns an action_id to poll with get_action_status.
| Parameter | Type |
|---|---|
url | string |
sender_id? | string |
max_age_hours? | integer |
check_inbox
GET /api/v1/inbox · read
Recent conversations across every sender in the workspace (or one sender), newest first, with the last messages of each.
| Parameter | Type |
|---|---|
since? | string |
sender_id? | string |
unread_only? | boolean |
tag? | string |
cursor? | string |
limit? | integer |
include_messages? | boolean |
get_thread
GET /api/v1/threads/{thread_id} · read
Full message history of one thread.
| Parameter | Type |
|---|---|
thread_id | string |
list_senders
GET /api/v1/senders · read
Senders in this workspace with status, health score, warmup stage and quota left today per action type.
get_sender_health
GET /api/v1/senders/{sender_id} · read
One sender's health score, warmup stage, quotas, proxy status and recent events (checkpoints, failures, accepts).
| Parameter | Type |
|---|---|
sender_id | string |
get_action_status
GET /api/v1/actions/{action_id} · read
Status and result of a queued action (scheduled, queued, running, succeeded, failed, cancelled, skipped).
| Parameter | Type |
|---|---|
action_id | string |
list_actions
GET /api/v1/actions · read
Recent actions, newest first, filterable by status, sender or campaign. Cursor-paginated.
| Parameter | Type |
|---|---|
status? | string |
sender_id? | string |
campaign? | string |
cursor? | string |
limit? | integer |
get_stats
GET /api/v1/stats · read
Acceptance and reply rates per sender and in total for a range (24h, 7d, 30d, 90d), optionally for one campaign.
| Parameter | Type |
|---|---|
range? | string |
sender_id? | string |
campaign? | string |
find_email
POST /api/v1/find_email · read
Find a work email for a profile. Costs 1 email credit only when an email is found; the result is kept only in this workspace.
| Parameter | Type |
|---|---|
url | string |