# List Employments

**GET /api/v2/employments**

List of all


## Servers
- https://api.plannrcrm.com: https://api.plannrcrm.com ()


## Authentication methods
- Personal access token & O auth2


## Parameters
### Headers
- **X-PLANNR-ACCOUNT-UUID** (string)



### Query parameters
- **filter[uuid]** (string)
  Filter by a comma separated list of UUIDs.
- **filter[account_uuids]** (string)
  Filter by a comma separated list of UUIDs.
- **filter[client_uuids]** (string)
  Filter by a comma separated list of UUIDs.
- **filter[status]** (string)
  Filter by a comma separated list of statuses.
- **filter[employer]** (string)
  Filter by employer name.
- **filter[job_title]** (string)
  Filter by job title.
- **filter[started_at]** (string)
  Filter by start date. Can use operands such as >=, <>, > and combine as a range by providing two values separated by comma.
- **filter[ended_at]** (string)
  Filter by end date. Can use operands such as >=, <>, > and combine as a range by providing two values separated by comma.
- **filter[email_address]** (string)
  Filter by job title.
- **filter[phone_number]** (string)
  Filter pby hone number - must have international code.
- **include** (string)
  A comma separated list of items to include. Possible values are [address, income, email_address, phone_number, turnover_history].
- **sort** (string)
  Field to sort by. Valid fields are [created_at, updated_at]. Negative sign to denote DESC.  Defaults to 'created_at'.
- **per_page** (integer)
  Number of results to return with pagination (Default 15. Max 500).


## Responses
### 200


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



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