marketplace

PATCH `/v1/marketplace/vendor/verification/subjects/{subject_id}`

Correct a person already on a file that is still editable.

Authentication

Send an API key as a bearer token. This endpoint checks no specific permission, so any key for your organisation can call it.

This endpoint takes no organisation id. Your key already identifies the organisation it belongs to, and the response is scoped to it.

Try it

Replace anything in angle brackets with your own values, and the key placeholder with a key from your dashboard.

curl -X PATCH https://api.zinndigital.com/v1/marketplace/vendor/verification/subjects/{subject_id} \
  -H "Authorization: Bearer zdk_live_…" \
  -H "Content-Type: application/json" \
  -d '{  }'

Signed in? The API console in your dashboard fills in your real organisation id and your own key, and runs the request against the live API so you can see the actual response. Open this endpoint in the API console

Details

Sets the person's name parts and date of birth (DAC7, docs/298 §2a) without removing them, so documents already uploaded against the person are kept. Only the keys sent are changed. Refused once the file is in review or approved. ⛔ Exists because an individual seller saved without first name, last name and date of birth had no way to add them — one person per individual file, and no edit path — and the payout gate demanded all three.

Parameters

Name	Type	Required	What it is
`subject_id (path)`	`string`	Yes	—

Request body

Name	Type	Required	What it is
`full_name`	`string`	No	—
`first_name`	`string`	No	—
`last_name`	`string`	No	—
`date_of_birth`	`string`	No	ISO `YYYY-MM-DD`. A future date or another format is a 422 naming the field.

Response

Name	Type	Required	What it is
`id`	`string`	Yes	—
`kind`	`MarketplaceVerificationSubjectKind`	Yes	Why a natural person appears on the file. `primary` is the individual themselves, or the person authorised to act for a company; `beneficial_owner` is a holder of more than 25%.…
`full_name`	`string`	Yes	—
`ownership_percent`	`integer`	No	Null on the individual track and for a pure authorised signatory. A holding of 25% or less is refused rather than recorded.
`is_authorised`	`boolean`	Yes	The person authorised to act. An individual is trivially that person.
`first_name`	`string`	No	DAC7 given name. Blank when not supplied.
`last_name`	`string`	No	DAC7 family name. Blank when not supplied.
`date_of_birth`	`string`	No	DAC7 date of birth. Null when not supplied.
`state`	`MarketplaceVerificationSubjectState`	Yes	—
`rejection_reason`	`string`	No	—

Errors this endpoint can return

401 · 404 · 422

PATCH /v1/marketplace/vendor/verification/subjects/{subject_id}