Update Customer

Update a customer's editable fields; new verification material rides the same PATCH.

curl -X PATCH "https://sandbox.rasto.co/api/customers/example_string" \
  -H "Content-Type: application/json" \
  -H "Api-Key: example_string" \
  -H "Api-Version: example_string" \
  -H "Api-Key: YOUR_API_KEY" \
  -d '{
  "tax_id": "example_string",
  "tax_residence_country": "USA",
  "employment_status": "employed",
  "occupation": "example_string",
  "source_of_funds": [
    "company_funds"
  ],
  "account_purpose": [
    "charitable_donations"
  ],
  "expected_monthly_volume_usd": "under_5k",
  "account_purpose_other": "example_string",
  "source_of_funds_description": "example_string",
  "source_of_wealth": [
    "affiliate_or_royalty_income"
  ],
  "source_of_wealth_description": "example_string",
  "estimated_annual_revenue_usd": 99999,
  "expected_monthly_payments_usd": 42,
  "ownership_structure": "bearer_shares_or_undisclosed_nominee_arrangement",
  "is_politically_exposed": true,
  "is_us_tax_person": true,
  "is_us_citizen": true,
  "is_funds_owner": true,
  "annual_income": "example_string",
  "monthly_transaction_count": "example_string",
  "activities": [
    "example_string"
  ],
  "first_name": "John Doe",
  "middle_name": "John Doe",
  "last_name": "John Doe",
  "email": "user@example.com",
  "phone": "+1-555-0123",
  "date_of_birth": "2024-12-25",
  "nationality": "example_string",
  "residence_country": "USA",
  "incorporation_date": "2024-12-25",
  "id_document": {
    "kind": "passport",
    "number": "example_string"
  },
  "legal_name": "John Doe",
  "trade_name": "John Doe",
  "business_description": "example_string",
  "business_kind": "cooperative",
  "business_industry": [
    "example_string"
  ],
  "registration_number": "example_string",
  "vat_number": "example_string",
  "website": "example_string",
  "address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "physical_address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "controllers": [
    {
      "first_name": "John Doe",
      "middle_name": "John Doe",
      "last_name": "John Doe",
      "date_of_birth": "2024-12-25",
      "nationality": "example_string",
      "address": {
        "street_line_1": "example_string",
        "street_line_2": "example_string",
        "postal_code": "example_string",
        "city": "New York",
        "country": "USA",
        "state": "example_string"
      },
      "phone": "+1-555-0123",
      "email": "user@example.com",
      "id": "example_string",
      "has_ownership": true,
      "ownership_percentage": 3.14,
      "has_control": true,
      "is_signer": true,
      "is_director": true,
      "role": "example_string",
      "id_document": {
        "kind": "passport",
        "number": "example_string"
      },
      "tax_id": "example_string",
      "tax_residence_country": "USA",
      "identifying_information": [
        {
          "kind": "passport",
          "issuing_country": "USA",
          "number": "example_string",
          "image_front": "example_string",
          "image_back": "example_string"
        }
      ],
      "documents": [
        {
          "purpose": "selfie",
          "file": "example_string"
        }
      ]
    }
  ],
  "identifying_information": [
    {
      "kind": "passport",
      "issuing_country": "USA",
      "number": "example_string",
      "image_front": "example_string",
      "image_back": "example_string"
    }
  ],
  "documents": [
    {
      "purpose": "selfie",
      "file": "example_string"
    }
  ],
  "endorsements": [
    "example_string"
  ],
  "tos_acceptance": {
    "ip_address": "123 Main St"
  }
}'

import requests
import json

url = "https://sandbox.rasto.co/api/customers/example_string"
headers = {
  "Content-Type": "application/json",
  "Api-Key": "YOUR_API_KEY",
  "Api-Version": "example_string"
}
data = {
  "tax_id": "example_string",
  "tax_residence_country": "USA",
  "employment_status": "employed",
  "occupation": "example_string",
  "source_of_funds": [
    "company_funds"
  ],
  "account_purpose": [
    "charitable_donations"
  ],
  "expected_monthly_volume_usd": "under_5k",
  "account_purpose_other": "example_string",
  "source_of_funds_description": "example_string",
  "source_of_wealth": [
    "affiliate_or_royalty_income"
  ],
  "source_of_wealth_description": "example_string",
  "estimated_annual_revenue_usd": 99999,
  "expected_monthly_payments_usd": 42,
  "ownership_structure": "bearer_shares_or_undisclosed_nominee_arrangement",
  "is_politically_exposed": true,
  "is_us_tax_person": true,
  "is_us_citizen": true,
  "is_funds_owner": true,
  "annual_income": "example_string",
  "monthly_transaction_count": "example_string",
  "activities": [
    "example_string"
  ],
  "first_name": "John Doe",
  "middle_name": "John Doe",
  "last_name": "John Doe",
  "email": "user@example.com",
  "phone": "+1-555-0123",
  "date_of_birth": "2024-12-25",
  "nationality": "example_string",
  "residence_country": "USA",
  "incorporation_date": "2024-12-25",
  "id_document": {
    "kind": "passport",
    "number": "example_string"
  },
  "legal_name": "John Doe",
  "trade_name": "John Doe",
  "business_description": "example_string",
  "business_kind": "cooperative",
  "business_industry": [
    "example_string"
  ],
  "registration_number": "example_string",
  "vat_number": "example_string",
  "website": "example_string",
  "address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "physical_address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "controllers": [
    {
      "first_name": "John Doe",
      "middle_name": "John Doe",
      "last_name": "John Doe",
      "date_of_birth": "2024-12-25",
      "nationality": "example_string",
      "address": {
        "street_line_1": "example_string",
        "street_line_2": "example_string",
        "postal_code": "example_string",
        "city": "New York",
        "country": "USA",
        "state": "example_string"
      },
      "phone": "+1-555-0123",
      "email": "user@example.com",
      "id": "example_string",
      "has_ownership": true,
      "ownership_percentage": 3.14,
      "has_control": true,
      "is_signer": true,
      "is_director": true,
      "role": "example_string",
      "id_document": {
        "kind": "passport",
        "number": "example_string"
      },
      "tax_id": "example_string",
      "tax_residence_country": "USA",
      "identifying_information": [
        {
          "kind": "passport",
          "issuing_country": "USA",
          "number": "example_string",
          "image_front": "example_string",
          "image_back": "example_string"
        }
      ],
      "documents": [
        {
          "purpose": "selfie",
          "file": "example_string"
        }
      ]
    }
  ],
  "identifying_information": [
    {
      "kind": "passport",
      "issuing_country": "USA",
      "number": "example_string",
      "image_front": "example_string",
      "image_back": "example_string"
    }
  ],
  "documents": [
    {
      "purpose": "selfie",
      "file": "example_string"
    }
  ],
  "endorsements": [
    "example_string"
  ],
  "tos_acceptance": {
    "ip_address": "123 Main St"
  }
}

response = requests.patch(url, headers=headers, json=data)
print(response.json())

const response = await fetch("https://sandbox.rasto.co/api/customers/example_string", {
  method: "PATCH",
  headers: {
  "Content-Type": "application/json",
  "Api-Key": "YOUR_API_KEY",
  "Api-Version": "example_string"
},
  body: JSON.stringify({
  "tax_id": "example_string",
  "tax_residence_country": "USA",
  "employment_status": "employed",
  "occupation": "example_string",
  "source_of_funds": [
    "company_funds"
  ],
  "account_purpose": [
    "charitable_donations"
  ],
  "expected_monthly_volume_usd": "under_5k",
  "account_purpose_other": "example_string",
  "source_of_funds_description": "example_string",
  "source_of_wealth": [
    "affiliate_or_royalty_income"
  ],
  "source_of_wealth_description": "example_string",
  "estimated_annual_revenue_usd": 99999,
  "expected_monthly_payments_usd": 42,
  "ownership_structure": "bearer_shares_or_undisclosed_nominee_arrangement",
  "is_politically_exposed": true,
  "is_us_tax_person": true,
  "is_us_citizen": true,
  "is_funds_owner": true,
  "annual_income": "example_string",
  "monthly_transaction_count": "example_string",
  "activities": [
    "example_string"
  ],
  "first_name": "John Doe",
  "middle_name": "John Doe",
  "last_name": "John Doe",
  "email": "user@example.com",
  "phone": "+1-555-0123",
  "date_of_birth": "2024-12-25",
  "nationality": "example_string",
  "residence_country": "USA",
  "incorporation_date": "2024-12-25",
  "id_document": {
    "kind": "passport",
    "number": "example_string"
  },
  "legal_name": "John Doe",
  "trade_name": "John Doe",
  "business_description": "example_string",
  "business_kind": "cooperative",
  "business_industry": [
    "example_string"
  ],
  "registration_number": "example_string",
  "vat_number": "example_string",
  "website": "example_string",
  "address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "physical_address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "controllers": [
    {
      "first_name": "John Doe",
      "middle_name": "John Doe",
      "last_name": "John Doe",
      "date_of_birth": "2024-12-25",
      "nationality": "example_string",
      "address": {
        "street_line_1": "example_string",
        "street_line_2": "example_string",
        "postal_code": "example_string",
        "city": "New York",
        "country": "USA",
        "state": "example_string"
      },
      "phone": "+1-555-0123",
      "email": "user@example.com",
      "id": "example_string",
      "has_ownership": true,
      "ownership_percentage": 3.14,
      "has_control": true,
      "is_signer": true,
      "is_director": true,
      "role": "example_string",
      "id_document": {
        "kind": "passport",
        "number": "example_string"
      },
      "tax_id": "example_string",
      "tax_residence_country": "USA",
      "identifying_information": [
        {
          "kind": "passport",
          "issuing_country": "USA",
          "number": "example_string",
          "image_front": "example_string",
          "image_back": "example_string"
        }
      ],
      "documents": [
        {
          "purpose": "selfie",
          "file": "example_string"
        }
      ]
    }
  ],
  "identifying_information": [
    {
      "kind": "passport",
      "issuing_country": "USA",
      "number": "example_string",
      "image_front": "example_string",
      "image_back": "example_string"
    }
  ],
  "documents": [
    {
      "purpose": "selfie",
      "file": "example_string"
    }
  ],
  "endorsements": [
    "example_string"
  ],
  "tos_acceptance": {
    "ip_address": "123 Main St"
  }
})
});

const data = await response.json();
console.log(data);

package main

import (
    "fmt"
    "net/http"
    "bytes"
    "encoding/json"
)

func main() {
    data := []byte(`{
  "tax_id": "example_string",
  "tax_residence_country": "USA",
  "employment_status": "employed",
  "occupation": "example_string",
  "source_of_funds": [
    "company_funds"
  ],
  "account_purpose": [
    "charitable_donations"
  ],
  "expected_monthly_volume_usd": "under_5k",
  "account_purpose_other": "example_string",
  "source_of_funds_description": "example_string",
  "source_of_wealth": [
    "affiliate_or_royalty_income"
  ],
  "source_of_wealth_description": "example_string",
  "estimated_annual_revenue_usd": 99999,
  "expected_monthly_payments_usd": 42,
  "ownership_structure": "bearer_shares_or_undisclosed_nominee_arrangement",
  "is_politically_exposed": true,
  "is_us_tax_person": true,
  "is_us_citizen": true,
  "is_funds_owner": true,
  "annual_income": "example_string",
  "monthly_transaction_count": "example_string",
  "activities": [
    "example_string"
  ],
  "first_name": "John Doe",
  "middle_name": "John Doe",
  "last_name": "John Doe",
  "email": "user@example.com",
  "phone": "+1-555-0123",
  "date_of_birth": "2024-12-25",
  "nationality": "example_string",
  "residence_country": "USA",
  "incorporation_date": "2024-12-25",
  "id_document": {
    "kind": "passport",
    "number": "example_string"
  },
  "legal_name": "John Doe",
  "trade_name": "John Doe",
  "business_description": "example_string",
  "business_kind": "cooperative",
  "business_industry": [
    "example_string"
  ],
  "registration_number": "example_string",
  "vat_number": "example_string",
  "website": "example_string",
  "address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "physical_address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "controllers": [
    {
      "first_name": "John Doe",
      "middle_name": "John Doe",
      "last_name": "John Doe",
      "date_of_birth": "2024-12-25",
      "nationality": "example_string",
      "address": {
        "street_line_1": "example_string",
        "street_line_2": "example_string",
        "postal_code": "example_string",
        "city": "New York",
        "country": "USA",
        "state": "example_string"
      },
      "phone": "+1-555-0123",
      "email": "user@example.com",
      "id": "example_string",
      "has_ownership": true,
      "ownership_percentage": 3.14,
      "has_control": true,
      "is_signer": true,
      "is_director": true,
      "role": "example_string",
      "id_document": {
        "kind": "passport",
        "number": "example_string"
      },
      "tax_id": "example_string",
      "tax_residence_country": "USA",
      "identifying_information": [
        {
          "kind": "passport",
          "issuing_country": "USA",
          "number": "example_string",
          "image_front": "example_string",
          "image_back": "example_string"
        }
      ],
      "documents": [
        {
          "purpose": "selfie",
          "file": "example_string"
        }
      ]
    }
  ],
  "identifying_information": [
    {
      "kind": "passport",
      "issuing_country": "USA",
      "number": "example_string",
      "image_front": "example_string",
      "image_back": "example_string"
    }
  ],
  "documents": [
    {
      "purpose": "selfie",
      "file": "example_string"
    }
  ],
  "endorsements": [
    "example_string"
  ],
  "tos_acceptance": {
    "ip_address": "123 Main St"
  }
}`)

    req, err := http.NewRequest("PATCH", "https://sandbox.rasto.co/api/customers/example_string", bytes.NewBuffer(data))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("Api-Key", "example_string")
    req.Header.Set("Api-Version", "example_string")
    req.Header.Set("Api-Key", "YOUR_API_KEY")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    fmt.Println("Response Status:", resp.Status)
}

require 'net/http'
require 'json'

uri = URI('https://sandbox.rasto.co/api/customers/example_string')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(uri)
request['Content-Type'] = 'application/json'
request['Api-Key'] = 'example_string'
request['Api-Version'] = 'example_string'
request['Api-Key'] = 'YOUR_API_KEY'
request.body = '{
  "tax_id": "example_string",
  "tax_residence_country": "USA",
  "employment_status": "employed",
  "occupation": "example_string",
  "source_of_funds": [
    "company_funds"
  ],
  "account_purpose": [
    "charitable_donations"
  ],
  "expected_monthly_volume_usd": "under_5k",
  "account_purpose_other": "example_string",
  "source_of_funds_description": "example_string",
  "source_of_wealth": [
    "affiliate_or_royalty_income"
  ],
  "source_of_wealth_description": "example_string",
  "estimated_annual_revenue_usd": 99999,
  "expected_monthly_payments_usd": 42,
  "ownership_structure": "bearer_shares_or_undisclosed_nominee_arrangement",
  "is_politically_exposed": true,
  "is_us_tax_person": true,
  "is_us_citizen": true,
  "is_funds_owner": true,
  "annual_income": "example_string",
  "monthly_transaction_count": "example_string",
  "activities": [
    "example_string"
  ],
  "first_name": "John Doe",
  "middle_name": "John Doe",
  "last_name": "John Doe",
  "email": "user@example.com",
  "phone": "+1-555-0123",
  "date_of_birth": "2024-12-25",
  "nationality": "example_string",
  "residence_country": "USA",
  "incorporation_date": "2024-12-25",
  "id_document": {
    "kind": "passport",
    "number": "example_string"
  },
  "legal_name": "John Doe",
  "trade_name": "John Doe",
  "business_description": "example_string",
  "business_kind": "cooperative",
  "business_industry": [
    "example_string"
  ],
  "registration_number": "example_string",
  "vat_number": "example_string",
  "website": "example_string",
  "address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "physical_address": {
    "street_line_1": "example_string",
    "street_line_2": "example_string",
    "postal_code": "example_string",
    "city": "New York",
    "country": "USA",
    "state": "example_string"
  },
  "controllers": [
    {
      "first_name": "John Doe",
      "middle_name": "John Doe",
      "last_name": "John Doe",
      "date_of_birth": "2024-12-25",
      "nationality": "example_string",
      "address": {
        "street_line_1": "example_string",
        "street_line_2": "example_string",
        "postal_code": "example_string",
        "city": "New York",
        "country": "USA",
        "state": "example_string"
      },
      "phone": "+1-555-0123",
      "email": "user@example.com",
      "id": "example_string",
      "has_ownership": true,
      "ownership_percentage": 3.14,
      "has_control": true,
      "is_signer": true,
      "is_director": true,
      "role": "example_string",
      "id_document": {
        "kind": "passport",
        "number": "example_string"
      },
      "tax_id": "example_string",
      "tax_residence_country": "USA",
      "identifying_information": [
        {
          "kind": "passport",
          "issuing_country": "USA",
          "number": "example_string",
          "image_front": "example_string",
          "image_back": "example_string"
        }
      ],
      "documents": [
        {
          "purpose": "selfie",
          "file": "example_string"
        }
      ]
    }
  ],
  "identifying_information": [
    {
      "kind": "passport",
      "issuing_country": "USA",
      "number": "example_string",
      "image_front": "example_string",
      "image_back": "example_string"
    }
  ],
  "documents": [
    {
      "purpose": "selfie",
      "file": "example_string"
    }
  ],
  "endorsements": [
    "example_string"
  ],
  "tos_acceptance": {
    "ip_address": "123 Main St"
  }
}'

response = http.request(request)
puts response.body

{}

PATCH

/api/customers/{customer_id}

PATCH

Base URLstring

Target server for requests. Edit to use your own host.

API Key (header: Api-Key)

Api-Keystring

Required

API key (sent in header)

The media type of the request body

Options: application/json

The /api contract to serve this request under, as an ISO date. Omit to use the default. Omitting it always keeps today's behaviour, so a future breaking change cannot move you. Supported: 2026-08-01.

tax_idstring

tax_residence_countrystring

employment_statusstring

occupationstring

source_of_fundsstring

account_purposestring

expected_monthly_volume_usdstring

account_purpose_otherstring

source_of_funds_descriptionstring

source_of_wealthstring

source_of_wealth_descriptionstring

estimated_annual_revenue_usdstring

expected_monthly_payments_usdstring

ownership_structurestring

is_politically_exposedstring

is_us_tax_personstring

is_us_citizenstring

is_funds_ownerstring

annual_incomestring

monthly_transaction_countstring

residence_countrystring

incorporation_datestring

id_documentstring

legal_namestring

trade_namestring

business_descriptionstring

business_kindstring

business_industrystring

registration_numberstring

vat_numberstring

websitestring

addressstring

physical_addressstring

controllersstring

identifying_informationstring

documentsstring

endorsementsstring

tos_acceptancestring

Request Preview

Response

Response will appear here after sending the request

Authentication

header

Api-Keystring

Required

API Key for authentication. Provide your API key in the header.

Path Parameters

customer_idstring

Required

Headers

Api-Keystring

Api-Versionstring

The /api contract to serve this request under, as an ISO date. Omit to use the default. Omitting it always keeps today's behaviour, so a future breaking change cannot move you. Supported: 2026-08-01.