Get Candidates

GET {{base_url_servicing}}/tokens/{{token_id}}/candidates

https://docs.tokeny.com/reference/getcandidates

Get Candidates

Get a list of candidates.

Filter your candidates levraging the Query Params.

🔐 Note that the authentication must provide sufficient privileges to access the information of the holder list. The HOLDER_MANAGEMENT permissions grant full access to the data.

RESPONSES

status: OK

{"items":[{"email":"publiclyavailabledummyinvestorno@yopmail.com","id":"a6b54404-2e2d-4c21-8b5d-5e4dd56f82b1","kycProvider":"MANUAL","kycStatus":"pending","lastLogin":"2023-01-18T16:36:33.154Z","createdAt":"2023-01-18T16:36:33.080Z","name":"inv1","currentSection":null,"status":"pending","investorType":"institution","country":"FRA","wallet":null,"walletProvider":null},{"email":"publiclyavailabledummyinvestorqm1@yopmail.com","id":"758080dc-da82-45d5-aa3c-55e3ca320173","kycProvider":"MANUAL","kycStatus":"pending","lastLogin":"2023-01-18T16:52:19.753Z","createdAt":"2023-01-18T16:52:19.654Z","name":"invqm1 invqm1","currentSection":null,"status":"pending","investorType":"individual","country":"LUX","wallet":"0xF0B9acc239740F2B6E5eF96D152A0Fb0f519326b","walletProvider":"USER_MANAGED"},{"email":"publiclyavailabledummyinvestorqm2@yopmail.com","id":"dcc27cdb-bbf5-491e-8130-dd29732d6441","kycProvider":"MANUAL","kycStatus":"approved","lastLogin":"2023-01-18T17:06:39.743Z","createdAt":"2023-01-18T17:06:38.980Z","name":"invqm2 invqm2","currentSection":null,"status":"qualified","investorType":"individual","country":"ESP","wallet":"0x252f9326D85e30328a4168E1F037d34A6FF9C9C7","walletProvider":"USER_MANAGED"},{"email":"publiclyavailabledummyinvestorqm3@yopmail.com","id":"f4a497a3-9491-46a5-9533-c12a7061f1b3","kycProvider":null,"kycStatus":"not_checked","lastLogin":"2023-03-10T09:42:40.961Z","createdAt":"2023-03-10T09:29:54.607Z","name":"","currentSection":"Agreements","status":"registered","investorType":"individual","country":"FRA","wallet":null,"walletProvider":null},{"email":"publiclyavailabledummyinvestorqm4@yopmail.com","id":"9d2bde1f-01e2-4f05-a627-41de1ebe1ba4","kycProvider":null,"kycStatus":"not_checked","lastLogin":"2023-03-10T13:21:05.898Z","createdAt":"2023-03-10T09:44:04.419Z","name":"","currentSection":"Agreements","status":"registered","investorType":"individual","country":"FRA","wallet":null,"walletProvider":null},{"email":"publiclyavailabledummyinvestorqm5@yopmail.com","id":"ddc2a8e7-a98c-424f-813e-5e7a21e4b967","kycProvider":null,"kycStatus":"not_checked","lastLogin":"2023-03-10T13:52:31.409Z","createdAt":"2023-03-10T13:36:12.507Z","name":"","currentSection":"Main information","status":"registered","investorType":"individual","country":"FRA","wallet":null,"walletProvider":null},{"email":"publiclyavailabledummyinvestorqm6@yopmail.com","id":"1e262072-9ed8-4be4-85a8-7806bf670737","kycProvider":null,"kycStatus":"not_checked","lastLogin":"2023-03-15T10:14:19.263Z","createdAt":"2023-03-10T14:33:01.286Z","name":"aaaaz aaa","currentSection":"Submit your information","status":"registered","investorType":"individual","country":"FRA","wallet":"0xdF5867FE5B2503144A0b0535DD8925d66a621724","walletProvider":"USER_MANAGED"}],"itemsReturned":7,"totalItemsFound":7,"totalPagesFound":1,"firstPageOffset":0,"lastPageOffset":0,"currentPage":1,"previousPageOffset":null,"nextPageOffset":null}