v2

latestOpenAPI 3.0.3CC BY 4.0 (data endpoints)2026-08-0518322234.1 KB
Voidly Pay

List hires a requester DID has posted

As a requester, fetch hires you've submitted. Use state=claimed to find hires awaiting your accept/dispute. REDACTED BY DEFAULT: this is a DID-keyed list, so the row id is omitted, along with requester_did, provider_did, input_json, input, output_json, output, task_id, escrow_id and receipt_id — an id shared across two per-DID lists is a join key that names the pair exactly. Accepting or disputing requires the receipt id, so an unproved caller can see that work is waiting but cannot act on it. Send x-voidly-proof signed by this DID to receive ids and full rows.

get/v1/pay/hire/outgoing/{did}

Path parameters

didstring required

Query parameters

statestring
limitinteger

Headers

x-voidly-proofstring

Proof of DID control. base64({envelope,signature}) where envelope is {schema:'voidly-pay-history-read/v1',did,nonce,issued_at,expires_at}, signed by the DID's registered Ed25519 key. Max window 5 minutes. Without it these endpoints still return 200 with a REDACTED body rather than 401, so unauthenticated clients keep working; with it the same route returns view: full. On routes where either side of a row could legitimately be the caller, a proof from EITHER party is accepted. Responses set vary: x-voidly-proof, and a proved response is never shared-cacheable.

Response

Hires