# Proof of Authorization Requests
> A request for proof of authorization for one or more ACH debit transfers.

[Events](https://increase.com/documentation/events.md) will be generated for this resource. The possible event categories are: `proof_of_authorization_request.created` and `proof_of_authorization_request.updated`.

## The Proof of Authorization Request object
### Example
```json
{
  "ach_transfers": [
    {
      "id": "ach_transfer_uoxatyh3lt5evrsdvo7q"
    }
  ],
  "created_at": "2020-01-31T23:59:59Z",
  "due_on": "2020-01-31T23:59:59Z",
  "id": "proof_of_authorization_request_iwp8no25h3rjvil6ad3b",
  "type": "proof_of_authorization_request",
  "updated_at": "2020-01-31T23:59:59Z"
}
```
### Attributes
- `ach_transfers` (array of objects)
  The ACH Transfers associated with the request.

  - `ach_transfers.id` (string)
    The ACH Transfer identifier.

- `created_at` (string)
  The time the Proof of Authorization Request was created.

- `due_on` (string)
  The time the Proof of Authorization Request is due.

- `id` (string)
  The Proof of Authorization Request identifier.

- `type` (string)
  A constant representing the object's type. For this resource it will always be `proof_of_authorization_request`.

- `updated_at` (string)
  The time the Proof of Authorization Request was last updated.

## List Proof of Authorization Requests
GET /proof_of_authorization_requests

### Example
```curl
curl \
  --url "${INCREASE_URL}/proof_of_authorization_requests" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"
```

### Query Parameters
- `cursor` (string, optional)
  Return the page of entries after this one.

- `limit` (integer, optional)
  Limit the size of the list that is returned. The default (and maximum) is 100 objects.

- `created_at.after` (string, optional)
  Return results after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

- `created_at.before` (string, optional)
  Return results before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

- `created_at.on_or_after` (string, optional)
  Return results on or after this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

- `created_at.on_or_before` (string, optional)
  Return results on or before this [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) timestamp.

### Returns a Proof of Authorization Request List object:
```json
{
  "data": [
    {
      "ach_transfers": [
        {
          "id": "ach_transfer_uoxatyh3lt5evrsdvo7q"
        }
      ],
      "created_at": "2020-01-31T23:59:59Z",
      "due_on": "2020-01-31T23:59:59Z",
      "id": "proof_of_authorization_request_iwp8no25h3rjvil6ad3b",
      "type": "proof_of_authorization_request",
      "updated_at": "2020-01-31T23:59:59Z"
    }
  ],
  "next_cursor": "v57w5d"
}
```

## Retrieve a Proof of Authorization Request
GET /proof_of_authorization_requests/{proof_of_authorization_request_id}

### Example
```curl
curl \
  --url "${INCREASE_URL}/proof_of_authorization_requests/proof_of_authorization_request_iwp8no25h3rjvil6ad3b" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}"
```
### Path Parameters
- `proof_of_authorization_request_id` (string, required)
  The identifier of the Proof of Authorization Request.