> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content.

# Get ReviewInvitation entities.

> Fetches ReviewInvitation entities. The dateFrom/dateTo range filters on the reservation, with referenceDate choosing the field, with the same range behavior as the reservation summaries endpoint; all three must be used together. Unsent invitations for reservations that departed yesterday can be fetched with status=unsent, referenceDate=date-to and dateFrom/dateTo set to yesterday. Each entity contains a url that redirects the guest to the review page; it can be used in an email as-is.

- Product: Review invitations
- Section: ReviewInvitation
- Snapshot: Current
- Method: `GET`
- Path: `/api/review_invitations/`

## Query parameters

### `status`

Type: `string`  
Required: no  

### `dateFrom`

Type: `string`  
Format: `date-time`  
Required: no  

### `dateTo`

Type: `string`  
Format: `date-time`  
Required: no  

### `referenceDate`

Type: `string`  
Required: no  

### `offset`

Type: `number`  
Required: no  
Default: `0`  

### `limit`

Type: `number`  
Required: no  
Default: `25`  

## Execute with TypeScript

Package: `@recranet/sdk`  

```ts
import { RecranetApiClient } from "@recranet/sdk";

const client = new RecranetApiClient({ apiKey: process.env.RECRANET_API_KEY! });

const result = await client.reviewInvitations.list();
```

## Execute with curl

```bash
curl "https://app.recranet.com/api/review_invitations/" \
    -H "X-Api-Key: $RECRANET_API_KEY"
```

## Responses

### Response `200`

Category: success  

Successful response

#### `application/json`

##### Generated example

```json
[
  {
    "id": 0,
    "token": "token",
    "url": "url",
    "sent": "sent"
  }
]
```

##### Schema

###### ReviewInvitation[]

Type: `ReviewInvitation[]`  

###### ReviewInvitation

Type: `ReviewInvitation`  

###### `id`

Type: `number`  
Required: yes  

###### `token`

Type: `string`  
Required: yes  

###### `url`

Type: `string`  
Required: yes  

###### `sent`

Type: `string`  
Format: `date-time`  
Required: no  

### Response `400`

Category: client-error  

Bad request

#### `application/json`

##### Example

```json
{
  "statusCode": 400,
  "description": "Bad request",
  "errors": [
    "Bad request"
  ]
}
```

##### Schema

###### object

Type: `object`  

## Related representations

- [Human documentation](/review-invitations/methods/list/)
- [TypeScript Markdown](/review-invitations/methods/list.md?lang=typescript)
- [curl Markdown](/review-invitations/methods/list.md?lang=curl)
- [site llms.txt](/llms.txt)
- [product llms.txt](/review-invitations/llms.txt)
- [snapshot llms.txt](/review-invitations/llms.txt)