Back to catalog

Sumble · Company Data

Sumble API / Unified people endpoint

Find, match, and enrich people. Provide a people list (list mode) or a filter (search mode) and compose the response with select. On v7 and earlier this endpoint is synchronous: one call returns the people. On v8 and later it is asynchronous in both modes. Send a people or filter body to start a background job — the response returns a requestid and status: "pending", and no credits are charged yet (the request is validated and your balance pre-checked, so you still get a 400/402 up front). Then send { "requestid": "..." } to the same endpoint to poll: you get status pending/running until it finishes, then succeeded (with the full people/total result) or failed. Credits are charged once, on the first succeeded poll; repeat polls report creditsused: 0. The async response adds requestid and status fields.

Private Gateway connection

Data below comes from the configured private Gateway. Provider activation remains governed by its evidence and policy gates.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • filter body · optional
  • limit body · optional

    Maximum number of people to return (filter mode only; ignored when `people` is provided).

  • offset body · optional

    Number of results to skip (filter mode only; ignored when `people` is provided).

  • order_by_column body · optional
  • order_by_direction body · optional
  • people body · optional
  • request_id body · optional
  • select body · optional

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.

Sumble API / Unified people endpoint · looot