Edit Shareholder Type

This POST method is required only in cases where there are no shareholders who own 25% or more of the company, and instead there is a CEO that is in charge of the organization.

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_.

Request Body Parameters

- is_shareholder_exists
- Indicates whether a shareholder exists. Set to false.

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.

/v1/verify/api/applications/:app_token/edit_shareholder_type

Edit Shareholder Type

curl -X post 'https://sandboxapi.rapyd.net/v1/verify/api/applications/app_e8b077318e02494c894c3b7f1ec7be7b/edit_shareholder_type' \
-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 '{
    "is_shareholder_exists": false
}'

{
    "status": {
        "error_code": "",
        "status": "SUCCESS",
        "message": "",
        "response_code": "",
        "operation_id": "ca8fe821-060c-4059-9d8c-09f777f8279c"
    },
    "data": {
        "token": "app_e8b077318e02494c894c3b7f1ec7be7b",
        "rapyd_entity_token": "ewallet_e19c0900567ee7fb18bf610095d76e98",
        "authorized_user_email": "test@test.com",
        "version": 4,
        "status": "new",
        "metadata": {
            "modular": "true"
        },
        "entity_type": "Private Limited Company",
        "country": "GB",
        "created_at": 1768212237643,
        "updated_at": 1768220994850,
        "sell_type": "ATS-0001",
        "business_industry": 4812,
        "triggers": { ... 
		}
... }
}

In this section:

Documentation