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

# Retrieve a List of API Clients

> GET /profiles/{profile_id}/api_clients
> 
> The API clients (applications) of the profile. A client is `{id, name, client_key, username, type, redirect_uris}`. `type` lists the grants the client may use: `jwt-bearer`, `authorization_code` (which also allows `refresh_token`), `password`. `username` is the user the client acts as.
> 
> The client secret is never returned here: it is answered once, by `POST .../api_clients` and by `POST .../api_clients/{client_id}/reset_secret`. Internal (`i_`) clients are not part of this resource.
> 
> A SERVER user sees every client of any profile. A COMPANY user sees the clients of their own profile whose acting user is not a server admin. BASIC users are forbidden.
> 
> Field grammar applies to `name`, `client_key` and `username`.



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


## Authentication methods
- Oauth2


## Parameters

### Path parameters

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


### Query parameters

- **fields** (string)
  Field grammar. Fields are `id`, `name`, `client_key`, `username`, `type`, `redirect_uris`; filters apply to `name`, `client_key` and `username`.

- **limit** (integer)
  Maximum number of clients returned (100 at most).

- **offset** (integer)
  Number of clients to skip.



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

- **Total-Count** (string)


#### Body: application/json (array[object])
- **id** (integer)

- **name** (string)

- **client_key** (string)

- **username** (string)
  the user the client acts as

- **type** (array[string])
  grants the client may use; `authorization_code` also allows `refresh_token`

- **redirect_uris** (array[string(uri)])


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

### 403
Forbidden - the token belongs to a BASIC user, or `profile_id` is not the caller's own profile.

### 404
Not Found - `profile_id` is not a valid profile id.


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