> For the complete documentation index, see [llms.txt](https://apidocs.zerionsoftware.com/doc/iformbuilder-v81/llms.txt)

# Retrieve a List of Page Statuses

> GET /profiles/{profile_id}/page_status
> 
> Returns the record count and the date and location of the last record change for every form in the profile that the caller may view, in one call. Each item is the row `GET .../pages/{page_id}/page_status` returns for that form.
> 
> ### Fields and filters
> 
> Standard list grammar. Default fields are `page_id`, `profile_id`, `row_count`, `last_modified_date` and `last_modified_location`; `id` is also available. Filter on the form with `fields=page_id(="790777")` or a range such as `fields=page_id(>"790000")`. The default order is `id` descending.
> 
> `limit` defaults to and is capped at 100. `Total-Count` is the number of matching rows before `limit` and `offset`.
> 
> ### Row count
> 
> `row_count` is returned as stored. A negative value means the count is unknown; the stored value is not recomputed by this endpoint.
> 
> ### Which forms are listed
> 
> Only forms that belong to the profile or are shared into it, the same set `GET .../pages/{page_id}/page_status` answers for. A form with no status row is not listed.
> 
> - Internal clients, COMPANY and SERVER users, and BASIC users with the form role see every such form.
> - BASIC users with the Record Assignment policy and no form role see the forms assigned to them for view or collect, directly, through a user group, through a page group, or through both.
> - Any other BASIC user gets `403`.
> 
> ### HTTP status
> 
> - `200` the list, possibly empty
> - `401` no valid bearer token
> - `403` another profile's `profile_id` and the caller is not a SERVER user, or a BASIC user with neither role
> - `404` unknown profile
> - `429` the endpoint rate limit was reached; this route shares the per-endpoint budget with the other page status routes
> 
> Reads may come from a read replica, so a just-written status can take a few seconds to show.



## Servers
- https://api.iformbuilder.com/exzact/api/v81/[servername]: https://api.iformbuilder.com/exzact/api/v81/[servername]


## Authentication methods
- Oauth2


## Parameters
### Headers

- **Authorization** (string)
  e.g. Bearer {access_token}


### Path parameters

- **profile_id** (string)
  id of the profile


### Query parameters

- **fields** (string)
  fields to return and filters, e.g. `page_id(="790777")`

- **limit** (number)
  maximum count of the page status list

- **offset** (number)
  skip that many page statuses before beginning to return



## Responses
### 200
OK
#### Headers

- **Total-Count** (string)
  number of rows that match the filter, ignoring `limit` and `offset`


#### Body: application/json (array[object])
- **id** (number)
  id of the status row; returned only when asked for in `fields`

- **page_id** (number)
  id of the form

- **profile_id** (number)
  id of the profile the status is kept for

- **row_count** (number)
  number of records on the form; negative when the count is unknown

- **last_modified_date** (string | null)
  date of the last record change, RFC 3339 in UTC

- **last_modified_location** (string | null)
  location of the last record change


### 400
Bad Request - `limit` or `offset` is not an integer.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure


### 401
Unauthorized - missing or invalid bearer token.

### 403
Forbidden - `profile_id` is not the caller's own profile (only SERVER users may name another profile), or the caller is a BASIC user with neither the form role nor the Record Assignment policy.

### 404
Not Found - the profile does not exist.

### 429
Too Many Requests - the per-server limit for this endpoint (`apiEndpointLimits`) was reached.

#### Body: application/json (object)
- **error_message** (string)
  human-readable reason for the failure



[Powered by Bump.sh](https://bump.sh)
