# Get a specific request

**GET /requests/{requestId}**

This endpoint retrieves all the details of a specific request including the answers of the forms and the documents that have been uploaded.


## Servers
- Production server.: https://api.usecollect.com/v1 (Production server.)


## Authentication methods
- Basic auth


## Parameters

#### Path parameters
- **requestId** (string)
  The ID of the request to retrieve.

#### Query parameters
- **expires** (integer)
  Specify the period of validity of the url to access the uploaded documents. Should be an integer, default is `900` (15 minutes) and maximum is `3600` (1 hour).



## Responses
### 200: Specific Request.

#### Body Parameters: application/json (object)
- **_id** (string)
  Request ID
- **campaignId** (string)
  Campaign ID
- **createdAt** (string(date-time))
  Request creation date
- **portalUrl** (string)
  URL of the portal for the main contact
- **status** (string)
  Request status
- **dueDate** (string)
  
- **privacy** (string)
  
- **contact** (object)
  
- **branding** (object)
  
- **documents** (array[object])
  
- **forms** (array[object])
  
- **texts** (array[object])
  
- **pages** (array[object])
  

### 400: Bad Request -- Your request is invalid.

### 401: Unauthorized -- Your API key is wrong.

### 403: Forbidden -- The object requested is hidden for administrators only.

### 404: Not Found -- The specified object could not be found.

### 429: Too Many Requests -- You're requesting too many objects! Slow down!

### 500: Internal Server Error -- We had a problem with our server. Try again later.

### 503: Service Unavailable -- We're temporarily offline for maintenance. Please try again later.


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