Check an Outreach Job

GET/api/v1/outreach/jobs/{id}

Retrieves the status and result of an outreach task. This endpoint supports task IDs returned by:

POST /api/v1/outreach/dispatches
POST /api/v1/outreach/linkedin/post-likes

Authentication

The request must use an API key from the account that created the task.

Path Parameters

Name	Type	Required	Description
`id`	string	Yes	The `item.id` returned by the creation endpoint.

Request

cURL
curl -X GET "https://revor.ai/api/v1/outreach/jobs/job_uuid" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Status Values

Status	Description
`queued`	The task has been created and is waiting to run.
`scheduled`	The task is scheduled to run later.
`running`	The task is running.
`succeeded`	The task completed successfully.
`failed`	The task failed.
`cancelled`	The task was cancelled.

Response

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "succeeded",
    "action": "outreach.dispatch",
    "channel": "email",
    "scheduled_at": "2026-05-20T10:00:00.000Z",
    "started_at": "2026-05-20T10:00:01.000Z",
    "finished_at": "2026-05-20T10:00:08.000Z",
    "attempt_count": 1,
    "next_attempt_at": null,
    "result": {
      "account_id": "connect_account_xxx",
      "channel": "email",
      "action": "outreach",
      "resolved_action": "message",
      "message_id": "message_xxx",
      "status": "accepted"
    },
    "error": null
  }
}

Response Fields

Field	Type	Description
`id`	string	Task ID.
`status`	string	Task status.
`action`	string	`outreach.dispatch` or `outreach.linkedin.post_like`.
`channel`	string	`email`, `linkedin`, or `whatsapp`.
`scheduled_at`	string \| null	Scheduled execution time.
`started_at`	string \| null	Start time.
`finished_at`	string \| null	Completion time.
`attempt_count`	number	Number of execution attempts.
`next_attempt_at`	string \| null	Next execution time.
`result`	object \| null	Successful result.
`error`	object \| null	Failure reason.

Successful Results

For outreach.dispatch, result.resolved_action indicates the performed outreach action.

`resolved_action`	Description
`message`	Email or WhatsApp message.
`direct_message`	LinkedIn direct message.
`invitation`	LinkedIn invitation.

For outreach.linkedin.post_like, result.status indicates the post-like result.

`result.status`	Description
`liked`	One relevant post was liked.
`skipped`	No relevant post was found, and no like was performed.

Failed Result

If task execution fails, this endpoint still returns HTTP 200; the failure is reported through item.status and item.error.

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "job_uuid",
    "status": "failed",
    "action": "outreach.dispatch",
    "channel": "linkedin",
    "attempt_count": 2,
    "result": null,
    "error": {
      "code": "connect_account_reconnect_required",
      "message": "connect_account_reconnect_required",
      "retryable": false
    }
  }
}

Request Errors

These errors indicate that the job lookup request failed.

HTTP	Code	Description
`401`	`api_key_missing`	No API key was provided.
`401`	`api_key_invalid`	The API key is invalid.
`403`	`permission_denied`	The API key does not have access to this task.
`404`	`task_not_found`	The task was not found.
`429`	`api_rate_limit_exceeded`	The request was rate limited.