# List crews active over a period

**GET /eTech/rest/ws/rostering/v1/crews**

Returns the crews active over the requested period, with the participation intervals of each resource, so that you can match technician time with equipment time (for invoicing, for instance).

**Rules**
- Crews carrying a disabling date, or whose main resource is inactive, are not returned.
- A crew is returned when at least one of its resources belongs to the office of the OAuth2 application or below. Secondary resources outside that hierarchy are hidden; the main resource is always shown.
- The main resource is not repeated among the secondary resources. The report filler is not part of a crew.
- Past periods can be queried: crews are returned as they are stored at call time.

Rate limit range : High


## Servers
- The node of your Praxedo instance (eu1, am1...).: https://ws-eu1.praxedo.com (The node of your Praxedo instance (eu1, am1...).)


## Authentication methods
- Bearer authentication


## Parameters


### Query parameters

- **startDate** (string(date-time))
  Start of the requested period, inclusive. RFC 3339 date-time with an offset.

- **endDate** (string(date-time))
  End of the requested period, exclusive. RFC 3339 date-time with an offset. Must be after `startDate`, at most 366 days later.

- **continuationToken** (string)
  The continuation token which was received in the previous request. It contains information on the page to fetch. If not present, then the first page of results will be returned.

- **size** (integer)
  Maximum number of crews returned per page. A value above 200 is capped to 200.



## Responses
### 200
OK – Crews active over the requested period.

#### Body: application/json (object)
- **continuationToken** (string | null)
  Opaque pagination token. Pass it back as the `continuationToken` query parameter to get the next page. null means last page. Do not parse or construct it.

- **data** (array[object])
  A crew, its main resource and its secondary resources, with their participation intervals.


### 400
Bad Request - invalid query parameters.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 401
Unauthorized - authentication issue.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 403
Forbidden - not enough rights.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 429
Too Many Requests.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.


### 500
Internal server error.

#### Body: application/json (object)
- **errors** (array[object])
  Array of errors. Contains at least one element.

- **errorReference** (string)
  Error unique reference. Communicated to support, this will help to locate the issue.



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