# Request Parameters

## amount
- **Type:** integer  
- **Required:** Yes  
- **Range:** 0 to 2000000000  
- **Description:** Amount (in cents) to authorize. This amount will override the transaction's amount that was originally set by /v1/simulate/authorize.

## token
- **Type:** uuid  
- **Required:** Yes  
- **Description:** The transaction token returned from the /v1/simulate/authorize response.

# Response Codes

## 201 OK
- **Object:**  
  - **debugging_request_id:** uuid  
    - Debugging request ID to share with Lithic Support team.  
  - **token:** uuid  
    - A unique token to reference this transaction.

## 400 Bad Request  
- A parameter in the query given in the request does not match the valid queries for the endpoint.

## 401 Unauthorized  
| Error | Description |
| --- | --- |
| User has not been authenticated | Invalid or missing API key |
| API key is not active | The API key used is no longer active |
| Could not find API key | The API key provided is not associated with any user |
| Please provide API key in Authorization header | The Authorization header is not in the request |
| Please provide API key in the form Authorization: \[api-key\] | The Authorization header is not formatted properly |
| Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](/content/contact/index.html) |
| Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |

## 422 Unprocessable Entity

## 429 Too Many Requests  
| Error | Description |
| --- | --- |
| Rate limited, too many requests per second | User has exceeded their per second rate limit |
| Rate limited, reached daily limit | User has exceeded their daily rate limit |
| Rate limited, too many keys tried | One IP has queried too many different API keys |

# Example Request

```bash
curl --request POST \
     --url https://sandbox.lithic.com/v1/simulate/authorization_advice \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '  
{  
  "amount": 3831,  
  "token": "fabd829d-7f7b-4432-a8f2-07ea4889aaac"  
}
'
```

# Example Response

```json
{  
  "debugging_request_id": "d31645af-da9e-4952-b7dc-3ffb06618b39",  
  "token": "fabd829d-7f7b-4432-a8f2-07ea4889aaac"  
}
```
