Change Application Type

This method changes the application type. Use this method when the applicant has chosen the wrong form of business entity. To get a list of application types for the applicant's country, use List Rapyd Verify Application Types.

Parameters

Request Header Parameters

- access_key
- Unique access key provided by Rapyd for each authorized user.
  See Developers.
- Content-Type
- Indicates that the data appears in JSON format. Set to application/json.
- idempotency
- A unique key that prevents the platform from creating the same object twice.
  See Idempotency.
- salt
- Random string. Recommended length: 8-16 characters.
- signature
- Signature calculated for each request individually.
  See Request Signatures.
- timestamp
- Timestamp for the request, in Unix time (seconds).
- api_timestamp
- Timestamp for the request, in Unix time (seconds).

Request Path Parameters

- app_token
- The application token identifier. String that starts with app_.

- app_type
- The revised application type. String that starts with typ_.

Request Body Parameters

- business_industry
- The revised business industry of the company as determined in step 1.

- sell_type
- The revised sell type of the company as determined in step 1.

Response

Note

Due to the length of the response, in this example on the right side of this page, a shortened version of the response is displayed.

The response includes the updated type and sections of the application.

/v1/verify/api/applications/:app_token/types/:app_type/switch

Change Application Type

curl -X post 'https://sandboxapi.rapyd.net/v1/verify/api/applications/app_e8b077318e02494c894c3b7f1ec7be7b/types/typ_WyJHQiIsMiwwLCJQcml2YXRlIExpbWl0ZWQgQ29tcGFueSJd/switch' \
-H 'access_key: your-access-key-here' \
-H 'Content-Type: application/json' \
-H 'idempotency: your-idempotency-parameter-here' \
-H 'salt: your-random-string-here' \
-H 'signature: your-calculated-signature-here' \
-H 'timestamp: your-unix-timestamp-here' \
-H 'api_timestamp: your-unix-timestamp-here' \
--data-raw '{}'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "132036d8-348a-41a3-bb5f-288b14741513"
    },
    "data": {
        "token": "app_e8b077318e02494c894c3b7f1ec7be7b",
        "rapyd_entity_token": "ewallet_e19c0900567ee7fb18bf610095d76e98",
        "authorized_user_email": "test@test.com",
        "version": 3,
        "status": "new",
        "metadata": {
            "modular": "true"
        },
        "entity_type": "Private Limited Company",
        "country": "GB",
        "created_at": 1768212237643,
        "updated_at": 1768212237795,
        "sell_type": "ATS-0001",
        "business_industry": 4812,
        "triggers": {...}
        ...}
...}

In this section:

Documentation