# Proof of Authorization Request Submissions
> Information submitted in response to a proof of authorization request. Per Nacha's guidance on proof of authorization, the originator must ensure that the authorization complies with applicable legal requirements, is readily identifiable as an authorization, and has clear and readily understandable terms.

## The Proof of Authorization Request Submission object
### Example
```json
{
  "additional_evidence_files": [
    {
      "file_id": "file_makxrc67oh9l6sg7w9yc"
    }
  ],
  "authorization_terms": "I agree to the terms.",
  "authorized_at": "2020-01-31T23:59:59Z",
  "authorizer_company": "National Phonograph Company",
  "authorizer_email": "user@example.com",
  "authorizer_ip_address": "123.45.67.89",
  "authorizer_name": "Ian Crease",
  "created_at": "2020-01-31T23:59:59Z",
  "customer_has_been_offboarded": false,
  "id": "proof_of_authorization_request_submission_uqhqroiley7n0097vizn",
  "idempotency_key": null,
  "originator_contact_information": "user@example.com",
  "originator_name": "National Phonograph Company",
  "proof_of_authorization_request_id": "proof_of_authorization_request_iwp8no25h3rjvil6ad3b",
  "status": "pending_review",
  "type": "proof_of_authorization_request_submission",
  "updated_at": "2020-01-31T23:59:59Z",
  "validated_account_ownership_via_credential": false,
  "validated_account_ownership_with_account_statement": false,
  "validated_account_ownership_with_microdeposit": true
}
```
### Attributes
- `additional_evidence_files` (array of objects)
  Files containing additional evidence.

  - `additional_evidence_files.file_id` (string)
    The File identifier.

- `authorization_terms` (string)
  Terms of authorization.

- `authorized_at` (string)
  Time of authorization.

- `authorizer_company` (string, nullable)
  Company of the authorizer.

- `authorizer_email` (string, nullable)
  Email of the authorizer.

- `authorizer_ip_address` (string, nullable)
  IP address of the authorizer.

- `authorizer_name` (string, nullable)
  Name of the authorizer.

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

- `customer_has_been_offboarded` (boolean, nullable)
  Whether the customer has been offboarded.

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

- `idempotency_key` (string, nullable)
  The idempotency key you chose for this object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

- `originator_contact_information` (string, nullable)
  Contact information for the originator.

- `originator_name` (string, nullable)
  Name of the originator.

- `proof_of_authorization_request_id` (string)
  ID of the proof of authorization request.

- `status` (enum)
  Status of the proof of authorization request submission.
  Cases:
  * `pending_review` (The proof of authorization request submission is pending review.)
  * `rejected` (The proof of authorization request submission was rejected.)
  * `canceled` (The proof of authorization request submission was canceled and replaced with another.)
  * `pending_sending` (The proof of authorization request submission is pending sending.)
  * `sending` (The proof of authorization request submission is pending sending.)
  * `sent` (The proof of authorization request submission was sent.)

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

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

- `validated_account_ownership_via_credential` (boolean, nullable)
  Whether account ownership was validated via credential (for instance, Plaid).

- `validated_account_ownership_with_account_statement` (boolean, nullable)
  Whether account ownership was validated with an account statement.

- `validated_account_ownership_with_microdeposit` (boolean, nullable)
  Whether account ownership was validated with microdeposit.

## List Proof of Authorization Request Submissions
GET /proof_of_authorization_request_submissions

### Example
```curl
curl \
  --url "${INCREASE_URL}/proof_of_authorization_request_submissions?proof_of_authorization_request_id=proof_of_authorization_request_iwp8no25h3rjvil6ad3b" \
  -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.

- `proof_of_authorization_request_id` (string, optional)
  ID of the proof of authorization request.

- `idempotency_key` (string, optional)
  Filter records to the one with the specified `idempotency_key` you chose for that object. This value is unique across Increase and is used to ensure that a request is only processed once. Learn more about [idempotency](https://increase.com/documentation/idempotency-keys).

### Returns a Proof of Authorization Request Submission List object:
```json
{
  "data": [
    {
      "additional_evidence_files": [
        {
          "file_id": "file_makxrc67oh9l6sg7w9yc"
        }
      ],
      "authorization_terms": "I agree to the terms.",
      "authorized_at": "2020-01-31T23:59:59Z",
      "authorizer_company": "National Phonograph Company",
      "authorizer_email": "user@example.com",
      "authorizer_ip_address": "123.45.67.89",
      "authorizer_name": "Ian Crease",
      "created_at": "2020-01-31T23:59:59Z",
      "customer_has_been_offboarded": false,
      "id": "proof_of_authorization_request_submission_uqhqroiley7n0097vizn",
      "idempotency_key": null,
      "originator_contact_information": "user@example.com",
      "originator_name": "National Phonograph Company",
      "proof_of_authorization_request_id": "proof_of_authorization_request_iwp8no25h3rjvil6ad3b",
      "status": "pending_review",
      "type": "proof_of_authorization_request_submission",
      "updated_at": "2020-01-31T23:59:59Z",
      "validated_account_ownership_via_credential": false,
      "validated_account_ownership_with_account_statement": false,
      "validated_account_ownership_with_microdeposit": true
    }
  ],
  "next_cursor": "v57w5d"
}
```

## Submit Proof of Authorization
POST /proof_of_authorization_request_submissions

### Example
```curl
curl -X "POST" \
  --url "${INCREASE_URL}/proof_of_authorization_request_submissions" \
  -H "Authorization: Bearer ${INCREASE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d $'{
    "additional_evidence_file_id": "file_makxrc67oh9l6sg7w9yc",
    "authorization_terms": "I agree to the terms of service.",
    "authorized_at": "2020-01-31T23:59:59Z",
    "authorizer_company": "National Phonograph Company",
    "authorizer_email": "user@example.com",
    "authorizer_name": "Ian Crease",
    "customer_has_been_offboarded": true,
    "originator_contact_information": "user@example.com",
    "originator_name": "National Phonograph Company",
    "proof_of_authorization_request_id": "proof_of_authorization_request_iwp8no25h3rjvil6ad3b",
    "validated_account_ownership_via_credential": true,
    "validated_account_ownership_with_account_statement": true,
    "validated_account_ownership_with_microdeposit": true
  }'
```

### Body Parameters
- `additional_evidence_file_id` (string, optional)
  File containing additional evidence.

- `authorization_terms` (string, required)
  Terms of authorization.

- `authorized_at` (string, required)
  Time of authorization.

- `authorizer_company` (string, optional)
  Company of the authorizer.

- `authorizer_email` (string, required)
  Email of the authorizer.

- `authorizer_ip_address` (string, optional)
  IP address of the authorizer.

- `authorizer_name` (string, required)
  Name of the authorizer.

- `customer_has_been_offboarded` (boolean, required)
  Whether the customer has been offboarded or suspended.

- `originator_contact_information` (string, required)
  Contact information of the originator.

- `originator_name` (string, required)
  Name of the originator.

- `proof_of_authorization_request_id` (string, required)
  ID of the proof of authorization request.

- `validated_account_ownership_via_credential` (boolean, required)
  Whether the account ownership was validated via credential (e.g. Plaid).

- `validated_account_ownership_with_account_statement` (boolean, required)
  Whether the account ownership was validated with an account statement.

- `validated_account_ownership_with_microdeposit` (boolean, required)
  Whether the account ownership was validated with a microdeposit.

## Retrieve a Proof of Authorization Request Submission
GET /proof_of_authorization_request_submissions/{proof_of_authorization_request_submission_id}

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