prospects

Acknowledge prospect delivery (batch).

Marks one or more domains delivered so they aren't returned again. Job-blind by design: one ack marks each domain delivered across all of the caller's jobs. Idempotent: an unknown or already-acknowledged domain is a harmless no-op (returns 200 with a count that reflects only the records actually marked), so clients never need to special-case them.

post/api/v1/prospects/ack

Request

  • Base URL: https://api.prosp.cc
  • URL: https://api.prosp.cc/api/v1/prospects/ack
  • Auth: OAuth 2 (client credentials, token URL https://prosp-mcp-641053169627.auth.eu-central-1.amazoncognito.com/oauth2/token, scopes: mcp/execute)

Request body

domainsstring[] required

Domains to acknowledge. Each is marked delivered so it isn't returned again across any of your discoveries. Idempotent — acking an unknown or already-acknowledged domain is a harmless no-op that simply contributes 0 to the count.

Example request

{
  "domains": [
    "acme.de",
    "example.de"
  ]
}

Response

Acknowledged.

customer_idstring

The acknowledging customer's id (echoed from the X-Customer-Id header).

acknowledgedinteger

Number of prospect records marked delivered across the requested domains. Idempotent — unknown or already-acknowledged domains contribute 0.

matchedinteger

How many of the requested domains belong to this customer (already-acknowledged ones included). When it is 0 — every requested domain is unknown to this customer — the call answers 404 instead of a 200 that acknowledged nothing.

requestedinteger

Number of domains in the request.

Changes

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