# Create a new data request

**POST /requests**

Used by the authenticated user to create a new data request from the organisation. The amount of data requests that can be simultaneously in progress is set by the organisation, and can be retrieved from the `/settings` endpoint.


## Servers


## Authentication methods
- O auth


## Parameters



### Body:  (array[string])
Describes the datatypes that the user wishes to request from the organisation. These must match the `type` parameters that are available form the `/data` eindpoint. If the request body is omitted, the data request is created for all available data types.
array[string]

## Responses
### 200
OK

#### Body:  (object)
- **requestId** (string(uuid))
  A random identifier that uniquely identifies a request. A version 4 UUID is strongly recommended. Note: the generated identifier must be random. The identifier must not include any information that can be related to the requester. Additionally, requestIds must not be incremental.
- **createdAt** (string(date-time))
  A date-time detailing when the request was made
- **expectedCompletion** (string(date-time))
  An optional date-time detailing when the request is expected to be completed
- **isCompleted** (boolean)
  Whether the request has been completed already
- **completedAt** (string(date-time))
  An optional date-time detailing when the request was completed.
- **dataRequested** (array[string])
  Identifier of a data type that was requested

### 400
Bad Request

#### Body:  (object)
- **error** (string)

- **message** (string)


### 401
Unauthorized

#### Body:  (object)
- **error** (string)

- **message** (string)



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