This endpoint allows you to retrieve the current automatic anticipation configuration of the account.
Automatic anticipation is a feature that automatically advances the settlement of credit card sales, eliminating the need to manually request anticipation for each individual charge. By retrieving this configuration, your application can determine whether the feature is enabled, which parameters are currently configured, and how future receivables will be processed.
When to use
This endpoint is recommended for integrations that need to:
- Display the current automatic anticipation status to users.
- Validate whether automatic anticipation is enabled before presenting features related to receivables management.
- Synchronize financial settings between Asaas and external systems.
- Audit or monitor changes to the account's automatic anticipation configuration.
A common scenario is financial platforms or ERPs that need to display receivables forecasts based on the anticipation behavior configured for the account.
The role of automatic anticipation in the financial flow
When automatic anticipation is enabled, receivables generated from installment or one-time credit card sales may be settled before their original payment date, according to the rules configured for the account.
Instead of manually requesting anticipation for each charge, the process is automatically applied to eligible receivables.
Simplified flow:
Credit card charge paid
↓
Receivable generated
↓
Anticipation rules validation
↓
Automatic anticipation executed
↓
Funds made available in advanceReturned information
The response from this endpoint allows you to identify important information about the active configuration, such as:
- Automatic anticipation status.
- Rules currently configured for the account.
- Criteria used to anticipate receivables.
- Other parameters related to automatic anticipation processing.
This information can be used to display administrative dashboards, generate financial reports, or perform internal integration validations.
ImportantThe availability of automatic anticipation depends on account eligibility and the policies currently in effect for the product. Not all accounts have this feature enabled.
Operational impacts
Automatic anticipation can change the expected settlement schedule of credit card receivables.
For this reason, integrations that perform:
- cash flow projections;
- financial reconciliation;
- future balance forecasting;
- receivables reporting;
should consider the configuration returned by this endpoint to accurately reflect settlement amounts and dates.
Best practices
- Retrieve this configuration periodically if your application relies on financial forecasting.
- Do not assume that automatic anticipation is enabled for all accounts.
- Consider that changes made by users in the Asaas environment may affect future receivables behavior.
- Use the returned data to keep dashboards and financial reports up to date.
Possible errors
403 - Forbidden
This error may occur when a GET request is sent with content in the request body.
GET requests must be sent without a request body.
Related content
- Configure automatic anticipation.
- Request manual anticipation.
- Retrieve anticipations.
- Credit card receivables.
- Financial statement.
403Forbidden. Occurs when the request body is filled, GET method calls must have an empty body.
