Signals

Accept a Company Followers extraction quote

Accept the quote of a Company Followers signal and start the extraction: the matching followers are extracted, enriched and delivered as leads to your webhookUrl and connected destinations.

Input: the signal ID in the path; no body. The signal must have a quoted extraction.

Output: extraction with status: accepted (then processing, results_ready, settled — follow it with GET .../extraction) and creditsHeld equal to the quote.

Credits: accepting holds the quoted credits on your balance. When the extraction settles you are charged for the leads actually delivered (never more than the hold) and the rest is returned (creditsReleased); if nothing is delivered, the whole hold is returned. Optional enrichments (emails, phones, ...) are charged per success at delivery, as on every signal. The price is re-checked at acceptance against the live follower count.

Errors: NO_QUOTE (404, never quoted, declined, or the quote expired — request a new one), NOT_QUOTED (409, still awaiting_quote, or already accepted), NO_PRICE (409), INSUFFICIENT_CREDITS (402, balance below the quote — top up and accept again; the quote stays open), EXTRACTION_FAILED (502, the extraction could not start — the hold is returned, retry), UNSUPPORTED (400), COMPANY_PAGE_UNAVAILABLE (422, a linkedinCompanyUrls page does not exist on LinkedIn — error.companyUrls lists it; the quote is closed and nothing is held; replace it with PATCH /api/v1/signals/{signal_id}), NOT_FOUND (404).

post/api/v1/signals/{signal_id}/extraction/accept

Request

Base URL: https://api.rodz.io (the document declares no server; this is the origin it was published from)
URL: https://api.rodz.io/api/v1/signals/{signal_id}/extraction/accept
Auth: HTTP bearer

Path parameters

signal_idstring required

Response

Successful Response

Example response

{
  "extraction": {
    "createdAt": "2026-10-09T09:15:00+00:00",
    "creditsCharged": 0,
    "creditsHeld": 0,
    "creditsQuoted": 620,
    "creditsReleased": 0,
    "estimatedFollowers": 1240,
    "expiresAt": "2026-11-08T09:15:00+00:00",
    "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "mode": "icp",
    "status": "quoted",
    "updatedAt": "2026-10-09T09:15:02+00:00"
  }
}

Changes

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