Skip to main content
All list endpoints return paginated results using cursor-based pagination. This approach provides stable, consistent paging even when new records are created between requests.

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger20Number of items per page (1—100)
cursorstring—Opaque cursor from a previous response

​
Response Shape

Every list endpoint returns a data array and a _meta object: 
{
  "data": [
    { "id": "prj_01JABCD123", "name": "City Tower Phase 2", ... },
    { "id": "prj_01JABCD456", "name": "Harbor Bridge Retrofit", ... }
  ],
  "_meta": {
    "next": "eyJpZCI6InByal8wMUpBQkNENDU2IiwiY3JlYXRlZF9hdCI6IjIwMjQtMDYtMTVUMTA6MzA6MDBaIn0",
    "prev": "eyJpZCI6InByal8wMUpBQkNEMTIzIiwiY3JlYXRlZF9hdCI6IjIwMjQtMDYtMTZUMDg6MDA6MDBaIn0",
    "limit": 20
  }
}
FieldDescription
_meta.nextCursor pointing to the next page. null when there are no more results.
_meta.prevCursor pointing to the previous page. null on the first page.
_meta.limitThe limit that was applied to this request.

​
Paging Forward

Pass the next cursor from the previous response to fetch the next page: 
# First page
curl "https://api.bedrock.cv/projects?limit=20" \
  -H "Authorization: Bearer sk_xxx"

# Next page
curl "https://api.bedrock.cv/projects?limit=20&cursor=eyJpZCI6InBya..." \
  -H "Authorization: Bearer sk_xxx"
Continue until _meta.next is null.

​
Paging Backward

Pass the prev cursor to go back one page. This is useful for building “Previous / Next” navigation in a UI. 
curl "https://api.bedrock.cv/projects?limit=20&cursor=eyJpZCI6InBya..." \
  -H "Authorization: Bearer sk_xxx"

​
Sort Order

Results are sorted by creation date descending (newest first), with id as a tiebreaker. This order is fixed and cannot be changed via query parameters.

​
Cursor Format

Cursors are opaque strings — do not parse, construct, or store them long-term. They encode an internal position and may change format between API versions. Always use the cursor values returned in _meta.

​
Example: Fetching All Projects

#!/bin/bash
CURSOR=""
PAGE=1

while true; do
  URL="https://api.bedrock.cv/projects?limit=100"
  if [ -n "$CURSOR" ]; then
    URL="${URL}&cursor=${CURSOR}"
  fi

  RESPONSE=$(curl -s "$URL" -H "Authorization: Bearer sk_xxx")
  echo "Page $PAGE: $(echo "$RESPONSE" | jq '.data | length') items"

  CURSOR=$(echo "$RESPONSE" | jq -r '._meta.next // empty')
  if [ -z "$CURSOR" ]; then
    break
  fi
  PAGE=$((PAGE + 1))
done

​
Notes

  • The maximum limit is 100. Requests above this value are clamped to 100.
  • The minimum limit is 1.
  • An invalid or expired cursor returns a 400 Bad Request error.
  • File listing (GET /files) uses GCS continuation tokens instead of database cursors, but the response shape and query parameters are identical.