> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gr4vy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Receivable transactions

> Learn how to report on receivable transactions via the dashboard.

The `accounts_receivables` model allows setting one parameter.

1. `filters`: a dictionary of filters

<Tip>
  Note that the output fields are predefined and cannot be changed.

  The output data is sorted based on the timestamp of the receivable and then by its identifier.
  Sorting is only applied if the date-time filter has a duration of 31 days or less.
</Tip>

## `filters`

Filters allow filtering of the receivable transactions' data to be exported.

| Value       | Type             | Validation                     |
| ----------- | ---------------- | ------------------------------ |
| `timestamp` | `dict[str, str]` | See **date-time filter** below |

<Tip>
  **No filters**

  If no filters should be applied, just set `filters` as `null`
</Tip>

### Date-time filter

A date-time filter could be defined as follows.

```json theme={"system"}
{
    "start": str
    "end": str
}
```

`start` and `end` allow three types of values:

1. Valid ISO 8601 timestamp with or without timezone. UTC is assumed if the time zone is not specified.
2. Date-time placeholder to be set dynamically
3. `null`: this represents an open range

#### Validations

The validations below are checked:

1. `start <= end`, only when both are timestamps
2. `start` and `end` cannot be null at the same time

## Example

Example of report creation using the `accounts_receivables` model.

```json theme={"system"}
{
  "name": "Test report",
  "spec": {
    "model": "accounts_receivables",
    "params": {
      "filters": {
        "timestamp": {
          "start": "2023-01-01T00:00:00"
        }
      }
    }
  }
}
```