Submit a renewal request

Testing Env

https://demoapi.base93.com/api/v1/user/external/agent/

POST

renewals

Creates a new renewal request for the authenticated agent. The request is multipart/form-data. Text fields are sent as regular form fields; dynamic file fields from the form config are sent with the key prefix af_ followed by the field name (e.g. af_trade_license).

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params multipart/form-dataRequired

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://demoapi.base93.com/api/v1/user/external/agent/renewals' \
--header 'Authorization: Bearer <token>' \
--form 'company="664a1b2c3d4e5f6a7b8c9d0e"' \
--form 'external_company="{\"name\":\"Salesforce LLC\",\"country\":\"664a000000000000000000ae\",\"company_type\":\"LLC\",\"freezone\":\"IFZA\"}"' \
--form 'renewal_type="Trade License Renewal"' \
--form 'reference_id="REF-2024-001"' \
--form 'additional_fields="{\"trade_license_number\":\"TL-2024-001234\"}"' \
--form 'af_<field_name>=@""'

Responses

🟢201

application/json

Renewal request created

Bodyapplication/json

Example

{
    "status": true,
    "response_code": 201,
    "message": "Renewal request created successfully",
    "data": {
        "_id": "664a1b2c3d4e5f6a7b8c9d0f",
        "renewal_type": "Trade License Renewal",
        "status": "submitted"
    }
}

🟠400

Modified at 2026-10-28 09:48:40

Get a renewal by ID

Get a one-time download URL for any file owned by the agent