List Instances (v1)
Returns paginated GPU instances for the authenticated user with keyset pagination and label count aggregations.
Authorizations
API key must be provided in the Authorization header
Query Parameters
Instances per page. Default 25, max 25. Values ≤ 0 are treated as 5.
x <= 25Keyset pagination cursor from the previous response's next_token. An invalid token returns a 400 error.
JSON array of sort directives, e.g. [{"col":"id","dir":"asc"}]. Valid dir values: asc, desc (anything else treated as asc). id is always appended as a tiebreaker. Invalid column returns 400.
JSON array of column names to return, e.g. ["id","label","actual_status"]. Use ["*"] for all columns (default). Unknown column names are returned as null.
JSON object of column filters. Supported operators: eq, neq, gt, gte, lt, lte, in, notin.
Filterable columns: actual_status, gpu_name, verification, id, label, and other columns stored directly on the contract record. Computed fields (e.g. dph_total, num_gpus) are not filterable and return 400.
Response
Returns {success: true, total_instances, label_counts, instances_found, instances, next_token} with paginated instance data.
True on success
Total number of matching instances
Map of label string to instance count
Number of instances in this page
Array of instance objects
Pagination token for the next page, or null