Skip to main content
PATCH
/
client
/
contract
Update client contract inDevelopnent
curl --request PATCH \
  --url https://client-api.dev.finhost.io/client/contract \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contract": "BasicContract"
}
'
{
  "client": "73f86631-3aa8-4df3-a769-ed820761da8c",
  "adm": "adm:active",
  "kyc": "kyc:unconfirmed",
  "verifier": "sumsub",
  "applicant": "628f44511a86170001268e99",
  "agent": "39eab26c-8788-4375-810c-9807aaf98191",
  "context": "profile",
  "created": "2022-07-06T13:42:24.094Z",
  "updated": "2022-07-06T13:42:24.094Z",
  "contract": "BasicContract",
  "termsVersion": "2022-07-06T13:42:24.094Z",
  "termsAcceptedTs": "2022-07-06T13:42:24.094Z",
  "address": {
    "country": "USA",
    "postCode": "23453",
    "town": "Boston",
    "street": "Bandery 17",
    "streetLine2": "sub street",
    "state": "DE"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
contract
string
required

Contract identifier

Example:

"BasicContract"

Response

200 response

​
client
string<uuid>

Internal client ID

Example:

"73f86631-3aa8-4df3-a769-ed820761da8c"

​
adm
enum<string>

Administrative status

Available options:
adm:active,
adm:blocked,
adm:suspended
Example:

"adm:active"

​
kyc
enum<string>

Verification status

Available options:
kyc:unconfirmed,
kyc:confirmed,
kyc:pending,
kyc:rejected,
kyc:resubmission
Example:

"kyc:unconfirmed"

​
verifier
string

The service that verifies an applicant

Example:

"sumsub"

​
applicant
string

Applicant ID in the verification service

Example:

"628f44511a86170001268e99"

​
agent
string<uuid>

Internal agent ID

Example:

"39eab26c-8788-4375-810c-9807aaf98191"

​
context
string

Subset of the client information

Example:

"profile"

​
created
string<date-time>

When the client profile was created in RFC 3339 (section 5.6)

Example:

"2022-07-06T13:42:24.094Z"

​
updated
string<date-time>

Time of the last update in RFC 3339 (section 5.6)

Example:

"2022-07-06T13:42:24.094Z"

​
contract
string

User contract

Example:

"BasicContract"

​
termsVersion
string

User terms version accepted

Example:

"2022-07-06T13:42:24.094Z"

​
termsAcceptedTs
string

User terms accepted timestamp

Example:

"2022-07-06T13:42:24.094Z"

​
address
object