Skip to main content
POST
Request a credit facility renewal
Tilta automatically renews every credit facility approximately every three months, running a fresh underwriting review and extending the expiry date before the current period ends. If you need to renew a facility ahead of that schedule – for example, because a high-value buyer is approaching expiry and you want to ensure continuity, or because the buyer’s business profile has significantly improved since the last review – you can request an early renewal using this endpoint. The renewal triggers a new underwriting assessment and delivers the result via a FACILITY.RENEWAL.* webhook event.

Webhook events

The renewal result is delivered asynchronously. Subscribe to the following events in your webhook configuration:
Tilta handles automatic renewal for all active facilities before they expire. You only need to call this endpoint if you want to renew a facility ahead of the normal schedule – for example, to get a fresh credit assessment for a buyer who has grown substantially since their last review.
If a buyer’s credit facility has already expired, use this endpoint to request a renewal and restore their ability to place orders. After a FACILITY.RENEWAL.ACCEPTED event, the buyer’s available_amount is restored and new orders can be authorized immediately.
A renewal may result in a different credit limit than the buyer’s current one – the new underwriting review may increase or decrease the limit based on the buyer’s current creditworthiness. Ensure your platform handles limit changes gracefully, particularly if a buyer’s limit decreases after renewal.

Authorizations

Authorization
string
header
required

Your Tilta API key, sent as Bearer <key>.

Path Parameters

external_id
string
required

Unique identifier of a buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$

Response

The renewal of a credit facility has been requested.

buyer_external_id
string
required

Unique identifier for buyer.

Maximum string length: 100
Pattern: ^[a-zA-Z0-9-_]+$
Example:

"5f6374a46a5e8e0104aa5cd4"