---
updatedAt: 2025-05-13T09:50:08.000Z
agentTools:
  projectIndex: https://developers.virtualincentives.com/llms.txt
---

# Get Orders by Date

**Endpoint:** *`https://rest.virtualincentives.com/{version}/{format}/orders?start={startDate}&end={endDate}`*

**Method:** `GET`

# Definitions

| Field     | Type                          | Description                                                                                                 |
| --------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------- |
| programid | integer                       | The `programid` that the order was placed under.                                                            |
| date      | datetime                      | Order date for the request order. Format: MM/dd/yyyy HH:mm                                                  |
| status    | string(50)                    | Order status for the requested order.<br/><br/>**Note:** See [Appendix A](https://developers.virtualincentives.com/docs/appendix-1)  for definitions. |
| number    | **response only**<br/>integer | Order number generated upon successful creation.                                                            |
| clientid  | integer                       | Client supplied unique identifier for the order.                                                            |

# Examples

## Response XML

```text
<orders>
  <order>
    <number>27213905</number>
    <date>04/17/2018 18:10</date>
    <programid>26154</programid>
    <clientid />
    <status>completed</status>
  </order>
  <order>
    <number>27213909</number>
    <date>04/17/2018 18:13</date>
    <programid>26154</programid>
    <clientid />
    <status>completed</status>
  </order>
  <order>
    <number>27285729</number>
    <date>05/10/2018 15:07</date>
    <programid>26154</programid>
    <clientid />
    <status>completed</status>
  </order>
</orders>
```

## Response JSON

```text
{
  "orders": {
    "order": [
      {
        "number": "27213905",
        "date": "04/17/2018 18:10",
        "programid": "26154",
        "clientid": "",
        "status": "completed"
      },
      {
        "number": "27213909",
        "date": "04/17/2018 18:13",
        "programid": "26154",
        "clientid": "",
        "status": "completed"
      },
      {
        "number": "27285729",
        "date": "05/10/2018 15:07",
        "programid": "26154",
        "clientid": "",
        "status": "completed"
      }
    ]
  }
}
```