Count Requests - Penbox Documentation

Previous API version. Use GET /forms/count for new integrations. This route still works but is deprecated.

Get the total count of requests matching your filter criteria, with optional grouping by field values.

GET https://connect.penbox.io/v1/requests/count

Query Parameters

Parameter	Type	Description
`filter`	string	JSON-encoded filter object (same keys as `GET /requests`)
`group-by`	string	Group counts by `status`, `user.{field}`, or `data.{field}`

{ "count": 42 }

{
  "count": 42,
  "by": {
    "status": { "pending": 15, "completed": 20, "draft": 7 }
  }
}

cURL

curl 'https://connect.penbox.io/v1/requests/count?group-by=status' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Code	Description
`200`	Success
`400`	Bad Request — invalid filter or group-by
`401`	Unauthorized
`403`	Forbidden
`429`	Too Many Requests
`500`	Server Error