# 📡 Responses After sending a request, Saloon will return a `Response` class. This response class contains many helpful methods for interacting with your HTTP response like seeing the HTTP status code and retrieving the body. ```php send($request); $status = $response->status(); $body = $response->body(); ``` {% hint style="info" %} By default, Saloon will not throw an exception if a synchronous request fails. [Refer to the handling failures section for handling errors.](handling-failures.md) {% endhint %} ### Useful Methods Below are some of the key methods provided by Saloon's `Response` class.
| Method | Description |
|---|---|
status | Returns the response status code. |
headers | Returns all response headers |
header | Returns a given header |
body | Returns the raw response body as a string |
json | Retrieves a JSON response body and json_decodes it into an array. |
array | Alias of json |
collect | Retrieves a JSON response body and json_decodes it into a Laravel Collection. Requires illuminate/collections. |
object | Retrieves a JSON response body and json_decodes it into an object. |
xmlReader | Used for XML responses - returns a XML Wrangler reader. Requires saloonphp/xml-wrangler. |
dom | Used for HTML responses - returns a Symfony DOM Crawler instance. Requires symfony/dom-crawler. |
stream | Returns the response body as an instance of StreamInterface |
saveBodyToFile | Allows you to save the raw body to a file or open file resource. |
dto | Converts the response into a data-transfer object. You must define your DTO first, click here to read more. |
dtoOrFail | Will work just like dto but will throw an exception if the response is considered "failed". |
ok, successful, redirect, failed, clientError, serverError | Methods used to determine if a request was successful or not based on status code. The failed method can be customised. |
throw | Will throw an exception if the response is considered "failed". |
getPendingRequest | Returns the PendingRequest class that was built up for the request. |
getPsrRequest | Returns the PSR-7 request that was built up by Saloon |
getPsrResponse | Return the PSR-7 response that was built up by the HTTP client/sender. |
class ForgeConnector extends Connector
{
// ...
protected ?string $response = CustomResponse::class;
}
{% endtab %}
{% tab title="Request" %}
class GetServersRequest extends Request
{
// ...
protected ?string $response = CustomResponse::class;
}
{% endtab %}
{% endtabs %}
When you need a more advanced way to define a custom response, use the `resolveResponseClass` method on either the connector or request.
{% tabs %}
{% tab title="Connector" %}
```php
class ForgeConnector extends Connector
{
// ...
public function resolveResponseClass(): string
{
return CustomResponse::class;
}
}
```
{% endtab %}
{% tab title="Request" %}
```php
class GetServersRequest extends Request
{
// ...
public function resolveResponseClass(): string
{
return CustomResponse::class;
}
}
```
{% endtab %}
{% endtabs %}