POST
/
accounts
curl --request POST \
  --url https://sandbox.featherhq.com/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "external_id": "<string>",
  "prefix": "<string>",
  "customer": {
    "account_holder": {
      "account_holder_details": {
        "name": {
          "first_name": "<string>",
          "last_name": "<string>",
          "salutation": "<string>"
        },
        "country_of_birth": "<string>",
        "date_of_birth": "2023-12-25",
        "email": "jsmith@example.com",
        "num_dependents": 123,
        "address": {
          "street_1": "<string>",
          "street_2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "country": "<string>"
        },
        "same_mail_address": true,
        "mailing_address": {
          "street_1": "<string>",
          "street_2": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "country": "<string>"
        },
        "marital_status": "S",
        "phone": {
          "phone_type": "Mobile",
          "number": "<string>",
          "country": "<string>"
        },
        "identification": {
          "citizenship": "<string>",
          "issuing_country": "<string>",
          "identification_type": "<string>",
          "identification_num": "<string>"
        },
        "tax_residency": {
          "country": "<string>",
          "identification_num": "<string>"
        },
        "employment_type": "EMPLOYED",
        "employment_details": {
          "employer": "<string>",
          "employer_business": "<string>",
          "occupation": "<string>",
          "employer_address_country": "<string>",
          "employer_address_state": "<string>",
          "employer_address_city": "<string>",
          "employer_address_postal_code": "<string>",
          "employer_address_street": "<string>"
        },
        "w9": {
          "correct_tin_shown": true,
          "not_subject_backup_withholding": true,
          "us_person": true
        }
      },
      "financial_information": {
        "investment_experience": [
          {
            "asset_class": "STK",
            "knowledge_level": "None",
            "trades_per_year": 123,
            "years_trading": 123
          }
        ],
        "sources_of_wealth": [
          {
            "source_type": "SOW-IND-Allowance",
            "is_used_for_funds": true,
            "percentage": 123
          }
        ],
        "annual_net_income": 123,
        "liquid_net_worth": 123,
        "net_worth": 123
      }
    }
  },
  "accounts": {
    "external_id": "<string>",
    "account_type": "<string>",
    "investment_objectives": [
      "<string>"
    ],
    "ira_beneficiaries": [
      {
        "spouse_primary_beneficiary": true,
        "first_name": "<string>",
        "last_name": "<string>",
        "salutation": "<string>",
        "date_of_birth": "2023-12-25",
        "address": {
          "street_1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "country": "<string>"
        },
        "same_mail_address": true,
        "mailing_address": {
          "street_1": "<string>",
          "city": "<string>",
          "state": "<string>",
          "postal_code": "<string>",
          "country": "<string>"
        },
        "identification": {
          "citizenship": "<string>",
          "issuing_country": "<string>",
          "identification_type": "<string>",
          "identification_num": "<string>"
        },
        "relationship": "<string>",
        "external_id": "<string>"
      }
    ]
  },
  "documents": {
    "document_id": {
      "exec_ts": "<string>",
      "exec_login_ts": "<string>",
      "signed_by": "<string>"
    }
  }
}'
{
  "message": "<string>"
}

Headers

x-api-key
string
required

API Key for authentication

Body

application/json
external_id
string

External ID of the customer

prefix
string

Prefix for the customer. Feather will provide one for your application.

customer
object

Account holder information

accounts
object

Account details

documents
object

Response

200 - application/json
message
string

A response message indicating success or failure