compliance
kyb
customer-session

Accept being the authorized signer

Changed on

The member a request names accepts, from their own session, and submits the identity details Stable Sea must verify for a new authorized signer: citizenship, date of birth, a US Social Security Number or a passport (a United States citizen gives an SSN; anyone else says whether they have a US SSN), and an address. The name comes from the member's record. Only that member can accept; the request then waits for a compliance operator, who reads the details with the SSN or passport number masked and can reveal the whole value, on the record. The details are sealed on the request and are never returned to the business: not to its admins and not in this answer. A body that does not match this schema (a missing field, a wrong type, a value over its length cap) is refused as invalid_field; a detail the schema accepts and the rules refuse (an ITIN, a date of birth that is not a real day or makes the signer younger than 18, a field the identifier class does not allow) is refused as signer_change_invalid. Neither refusal repeats a submitted value.

post/compliance/signer_changes/{id}/accept

Request

  • Base URL
    https://api.stablesea.com (the document declares no server; this is the origin it was published from)
  • URL
    https://api.stablesea.com/compliance/signer_changes/{id}/accept
  • Auth
    none declared

Path parameters

idstring required

Request body

address_citystring required
address_countrystring required

A country name like those in the KYB form's country list (only presence and length are checked).

address_statestring

Required when address_country is United States, as a state name from the KYB form's state list.

address_streetstring required
address_street_2string
address_zipstring required
citizenshipstring required

The signer's country of citizenship, as a country name like those in the KYB form's country list (only presence and length are checked), for example United States.

date_of_birthstring required

The signer's date of birth, YYYY-MM-DD. The signer must be at least 18 years old.

holds_us_ssnstring

Whether the signer has a US Social Security Number: Yes or No, as on the KYB form. Required when citizenship is not United States; refused when it is.

passport_countrystring

The country that issued the passport, as a country name like those in the KYB form's country list (only presence and length are checked).

passport_numberstring

The signer's passport number. Required, with passport_country, when the signer is not a United States citizen and has no US SSN; refused otherwise.

ssnstring

The signer's US Social Security Number. Required when the signer is a United States citizen or has a US SSN; refused otherwise. An ITIN is not accepted.

Response

OK

group_idstring required
idstring required
kind'replace' | 'add' required
new_signer_idstring required
reasonstring required
requested_bystring required
requested_by_namestring
requested_tsstring date-time required
signer_confirmed_tsstring date-time nullable
state'awaiting_signer' | 'awaiting_approval' | 'approved' | 'rejected' | 'cancelled' required

Changes

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the required property to the response with the status