VerifycateDeveloper Docs

List requests for a certificate

GET/api/v1/workspaces/{slug}/certificates/{id}/requests

List request-form submissions for one certificate

Lists request-form submissions for a single certificate. Supports search, status filter, and offset pagination.

Image and attachment values in fields are 15-minute private-bucket presigned GET URLs (not storage paths). Re-fetch the list if a URL has expired.

Authorization

Scopecertificates:read
Authorization: Bearer vc_...

Requires certificates:read (or full access) and an active Pro seat.

Path parameters

slug*string

Workspace slug

Example: acme
id*UUID

Certificate id

Example: 550e8400-e29b-41d4-a716-446655440000

Query parameters

status?string

Filter by status: pending, approved, or rejected. Omit for all.

Example: pending
limit?integer

Page size (1–200). Defaults to 50.

Example: 50
offset?integer

Number of items to skip. Defaults to 0.

Example: 0

Response schema

*Submission[]
Submissions for this certificate
id*UUID
Submission id
certificate_id*UUID
Certificate id
user_id?UUID
Linked user id when known
status*string
`pending`, `approved`, or `rejected`
fields*object
Submitted form field values (file fields may be signed URLs)
submitted_at?datetime
When the form was submitted
created_at*datetime
Created timestamp
total*integer
Total matching rows (not just this page)
limit*integer
Page size used for this response
offset*integer
Number of items skipped