---
title: "The Requests facade — Requests for Laravel | Roundly"
description: "Every Requests facade method in one place — create, approve, reject, reopen, cancel, expire, expireDue and canTransition."
url: https://roundly-consulting.com/open-source/docs/requests-for-laravel/facade
language: en
---

[All packages](https://roundly-consulting.com/open-source.md)

[Requests for Laravel](https://roundly-consulting.com/open-source/docs/requests-for-laravel.md)

# The Requests facade

The Requests facade is the recommended entry point. The fully-qualified RoundlyConsulting\\Requests\\Facades\\Requests always works; a short Requests alias is also registered when the name is free. It resolves RequestManager, so every call below also works on an injected manager (see DI, actions & the DTO). The full surface:

```php
use RoundlyConsulting\Requests\Enums\Status;
use RoundlyConsulting\Requests\Facades\Requests;

// Create — fluently, or from a ready DTO
$request = Requests::make()->author($user)->title('Expense reimbursement')
    ->requireApprovalsFrom([$alice, $bob])->create();
$request = Requests::create($dto);

// Decide — the reason is optional
Requests::approve($request, $alice, reason: 'Within budget');
Requests::reject($request, $carol, reason: 'Out of policy');
Requests::reopen($request, $alice);        // back to New — a finished round reopens fresh

// Close
Requests::cancel($request);                // status = Cancelled
Requests::expire($request);                // status = Expired
Requests::expireDue();                     // int — expire every open, past-due request

// Ask the lifecycle graph
Requests::canTransition($request, Status::Approved);   // bool
```

## Method reference

| Method | Returns | Purpose |
| --- | --- | --- |
| `make()` | `RequestBuilder` | Start a fluent request; ->create() saves it. |
| `create(CreateRequestDto $dto)` | `Request` | Create a request from a ready DTO. |
| `approve($request, $actor, ?$reason)` | `Request` | Record an approval; the rule decides when the request flips. A request past its deadline is expired instead. |
| `reject($request, $actor, ?$reason)` | `Request` | Record a rejection. |
| `reopen($request, $actor, ?$reason)` | `Request` | Back to New — a lifecycle move your app authorizes; withdraws the actor’s decision, or opens a fresh round once the last one is over. |
| `cancel($request)` | `Request` | Status Cancelled; closes the open approval round and releases its pending approvers. |
| `expire($request)` | `Request` | Status Expired; closes the open approval round. |
| `expireDue(bool $dryRun = false, int $chunk = 500)` | `int` | Expire every open, past-due request and return how many this call expired; a dry run only counts them. |
| `canTransition($request, Status $to)` | `bool` | Whether the lifecycle graph allows the move. |
| `fake()` | `RequestsFake` | Swap in the recording fake — see Testing. |

approve(), reject() and reopen() take any model that implements GivesApprovalsInterface. The fluent builder behind make() is covered in Creating requests.

## Show your open-source love

This package is free and MIT-licensed. If it saves you time, a one-off donation or a Patreon membership keeps it maintained, tested and documented.

[More ways to support, including crypto](https://roundly-consulting.com/support-us.md)

By donating, you agree to our [donation terms](https://roundly-consulting.com/donation-terms.md).

[Support our open source work (opens in a new tab)](https://donate.stripe.com/dRmeVe8FX5PF1Qd9pXcEw00) [Join us on Patreon (opens in a new tab)](https://www.patreon.com/cw/roundly)

## Want this built into your product?

We integrate our packages into custom Laravel and AI builds. Tell us what you're working on and we'll reply within 48 hours.

[Get a quote in 48 hours](https://roundly-consulting.com/contact.md) [Browse all packages](https://roundly-consulting.com/open-source/docs/requests-for-laravel.md)