Create an individual or business account holder

post https://api.privacy.com/v1/account_holders

Run an individual or business's information through the Customer Identification Program (CIP) and return an account_token if the status is accepted or pending (i.e., further action required).
All calls to this endpoint will return an immediate response - though in some cases, the response may indicate the workflow is under review or further action will be needed to complete the account creation process.
This endpoint can only be used on accounts that are part of the program the calling API key manages.

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: api-key [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Please contact api@privacy.com
Insufficient privileges to create unlocked cards.	Creating unlocked cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

Language

Credentials

Header

URL


xxxxxxxxxx
1
curl --request POST \
2
     --url https://api.privacy.com/v1/account_holders \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "workflow": "KYC_ADVANCED"
8
}
9
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK

400A parameter in the query given in the request does not match the valid queries for the endpoint.