Skip to main content
GET

Authorizations

Authorization
string
header
required

API key starting with sk_case_

Path Parameters

id
string
required

The unique identifier of the vault

Query Parameters

includeUnconfirmed
boolean
default:false

Include placeholders for uploads that were never completed (awaiting_upload) or were cancelled (aborted). Excluded by default.

file_origin
string

JSON-encoded provenance object used as a partial match. For example, {"provider":"clio"} returns objects whose file_origin contains that value.

Example:

"{\"provider\":\"clio\"}"

limit
integer

Objects per page (1-200). Omit to receive every object. Supplying a cursor without a limit uses 50.

Required range: 1 <= x <= 200
cursor
string

Opaque continuation cursor from pagination.next_cursor of the previous page. Must be replayed with the same API key scope and the same query, file_origin and includeUnconfirmed values that produced it.

query
string

Case-insensitive substring match on the filename.

include_totals
boolean

When true, adds totals covering every object matching the filters, not just this page. Request it once per filter change rather than on every page.

Response

Successfully retrieved vault objects

vaultId
string
required

The ID of the vault

objects
object[]
required
count
number
required

Number of objects in this response. Equals the vault total only when pagination.has_more is false; use totals.objects for the total across pages.

pagination
object
required
totals
object

Present only with include_totals=true. Covers every object matching the filters, across all pages.