API referenceTracking
Audit trail of the envelope
Scope envelopes:read. Every recorded action with who performed it and from which IP. Views of the envelope by your own team members are omitted.
apiKeyheader
AuthorizationBearer <fv_live_… or fv_test_…>id*stringFormat
uuidActivities in chronological order
application/json- response
success*booleanrequest_id*stringFormat
uuiddata?curl -X GET 'https://api.flowverify.co/v1/envelopes/497f6eca-6276-4993-bfeb-53cbbbba6f08/history'Example Response
{ "success": true, "request_id": "266ea41d-adf5-480b-af50-15b940c2b846", "data": { "object": "envelope_history", "envelope": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "reference": "string", "name": "string", "status": "draft", "type": "string", "created_at": "2019-08-24T14:15:22Z", "sent_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "timezone": "string" }, "sender": { "name": "string", "email": "string" }, "organization_name": "string", "recipients": [ { "object": "recipient", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "name": "string", "email": "string", "phone": "string", "role": "sign", "order": 0, "status": "pending", "language": "string", "auth": { "email_otp": true, "sms_otp": true }, "sent_at": "2019-08-24T14:15:22Z", "viewed_at": "2019-08-24T14:15:22Z", "signed_at": "2019-08-24T14:15:22Z", "declined_at": "2019-08-24T14:15:22Z", "decline_reason": "string" } ], "activities": [ { "object": "activity", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "action": "string", "label": "string", "description": "string", "performed_by": { "name": "string", "email": "string" }, "ip_address": "string", "occurred_at": "2019-08-24T14:15:22Z" } ] }}Signing progress summary GET
Scope `envelopes:read`.
Send one draft to many recipients POST
Scope `envelopes:send`. Clones the draft (one file, fields assigned to a single signer) once per recipient and sends each copy in the background. Plan-gated by `BULK_SEND` and `BULK_SEND_MAX_RECIPIENTS` (`feature_not_available` / `plan_limit_exceeded`); a second bulk send for the same draft while one is running is a `state_conflict` (`details.job_id`). Duplicate emails are dropped. Poll `GET /bulk-send-jobs/{id}`; `bulk_send.completed` fires when done.