Check many companies in one call

A read of up to 25 companies in one request, for an agent that plans a sequence of steps and needs to know, before acting, what each company's record says and whether it changed since planning. Each target is a domain or profile slug, or { q, pin } where pin is the record digest from an earlier read. Each result has status (listed, not_listed, withheld, unavailable), what Trooth's own readings show, the version and SHA-256 digest of the record GET /api/network/profile serves, pin.changed when a pin was sent, and plain day counts. A target that cannot be read is that target's unavailable, with the problem registry's retryable flag and next action; the other targets are still answered. It changes nothing, so it takes no Idempotency-Key and repeating it is always safe. Nothing in it grades, ranks or certifies a company. Errors are always RFC 9457 problem details. Never cached. Readable cross-origin: the response carries Access-Control-Allow-Origin: * and never Access-Control-Allow-Credentials, so a browser on any site may read it without cookies.

post/api/network/batch

Request

  • Base URL: https://trooth.co
  • URL: https://trooth.co/api/network/batch
  • Auth: none required

Request body

Response

One result per target, in the order sent.

format'trooth.network-batch.v1' required

Names this shape.

checked_atstring required

When this answer was read, ISO 8601.

how_to_readstring required

How to read this answer.

Changes

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