Customers

Retrieve Customer

Changed on Oct 15, 2026

get/v1/instances/{instance_id}/customers/{id}

Request

Base URL: https://blindpay.com (the document declares no server; this is the origin it was published from)
URL: https://blindpay.com/v1/instances/{instance_id}/customers/{id}
Auth: HTTP bearer

Path parameters

instance_idstring required

Example:in_000000000000

idstring required

Example:re_000000000000

Response

Get customer

idstring required

customer_idstring required

type'individual' | 'business' required

kyc_type'light' | 'standard' | 'enhanced' required

Use standard for individuals and businesses, or enhanced for individuals. light is not available for new customers, and businesses only support standard.

emailstring email required

tax_idstring nullable

address_line_1string nullable

address_line_2string nullable

citystring nullable

state_province_regionstring nullable

country'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'CV' | 'KH' | 'CM' | 'CA' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CD' | 'CG' | 'CK' | 'CR' | 'HR' | 'CU' | 'CW' | 'CY' | 'CZ' | 'CI' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'MK' | 'RO' | 'RU' | 'RW' | 'RE' | 'BL' | 'SH' | 'KN' | 'LC' | 'MF' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SX' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'SS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'UM' | 'US' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' required

postal_codestring nullable

ip_addressstring ip nullable

latitudenumber nullable

Optional geolocation latitude collected from the customer. Forwarded to AiPrise and SEON for fraud analysis.

longitudenumber nullable

Optional geolocation longitude collected from the customer. Forwarded to AiPrise and SEON for fraud analysis.

image_urlstring nullable

phone_numberstring nullable

proof_of_address_doc_type'UTILITY_BILL' | 'BANK_STATEMENT' | 'RENTAL_AGREEMENT' | 'TAX_DOCUMENT' | 'GOVERNMENT_CORRESPONDENCE' nullable

proof_of_address_doc_filestring nullable

Please upload one document that serve as proof of address, this needs to be the same physical address as the one provided above. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB.

first_namestring nullable

last_namestring nullable

id_doc_country'AF' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'CV' | 'KH' | 'CM' | 'CA' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CD' | 'CG' | 'CK' | 'CR' | 'HR' | 'CU' | 'CW' | 'CY' | 'CZ' | 'CI' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'SZ' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'MK' | 'RO' | 'RU' | 'RW' | 'RE' | 'BL' | 'SH' | 'KN' | 'LC' | 'MF' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SX' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'SS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'UM' | 'US' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AX' nullable

id_doc_type'PASSPORT' | 'ID_CARD' | 'DRIVERS' nullable

id_doc_front_filestring nullable

Only image files are accepted (.jpg, .jpeg, .png)

id_doc_back_filestring nullable

Only image files are accepted (.jpg, .jpeg, .png)

legal_namestring nullable

alternate_namestring nullable

websitestring uri nullable

incorporation_doc_filestring nullable

Please upload your articles of incorporation below. The articles of incorporation or a certificate of incorporation usually includes information like the company name, business purpose, number of shares offered, value of shares, etc. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB.

proof_of_ownership_doc_filestring nullable

Please upload your proof of ownership below. This document usually includes information like the shareholders names and percentages. Only PDF and image files are accepted (.jpg, .jpeg, .png, .pdf) with a maximum size of 3MB.

source_of_funds_doc_filestring nullable

selfie_filestring nullable

Only image files are accepted (.jpg, .jpeg, .png)

purpose_of_transactions_explanationstring nullable

is_fboboolean nullable

is_nestedboolean nullable

Set by BlindPay compliance for nested customers (fintechs and PSPs). Only first-party transactions are allowed; third-party payins and payouts are held for manual review.

account_purpose_otherstring nullable

Required when account_purpose is "other". Max 512 characters.

business_descriptionstring nullable

business_industrystring nullable

estimated_annual_revenue'0_99999' | '100000_999999' | '1000000_9999999' | '10000000_49999999' | '50000000_249999999' | '250000000_plus' nullable

publicly_tradedboolean nullable

occupationstring nullable

external_idstring nullable

instance_idstring required

tos_idstring nullable

aml_status'clear' | 'hit' | 'error' nullable

AML screening status from SEON. null = not yet screened.

created_atstring date-time nullable

updated_atstring date-time nullable

is_tos_acceptedboolean nullable

Example response

{
  "id": "re_000000000000",
  "customer_id": "re_000000000000",
  "type": "individual",
  "kyc_type": "standard",
  "kyc_status": "verifying",
  "kyc_warnings": [
    {
      "code": "BIRTH_DATE_MISMATCH",
      "message": "Mismatch between supplied birth date and extracted/looked up birth date.",
      "resolution_status": "UNRESOLVED",
      "warning_id": "38170889-50aa-4271-9eb1-61113ebf408c"
    }
  ],
  "fraud_warnings": [
    {
      "id": "UC114",
      "name": "User never used a Datacenter proxy and this device before",
      "operation": "+",
      "score": 10
    }
  ],
  "email": "email@example.com",
  "tax_id": "536804398",
  "address_line_1": "738 Plain St",
  "address_line_2": "Building 22",
  "city": "Marshfield",
  "state_province_region": "MA",
  "country": "US",
  "postal_code": "02050",
  "ip_address": "127.0.0.1",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "image_url": "https://example.com/image.png",
  "phone_number": "+13055555555",
  "proof_of_address_doc_type": "UTILITY_BILL",
  "proof_of_address_doc_file": "https://example.com/image.png",
  "first_name": "John",
  "last_name": "Doe",
  "id_doc_country": "BR",
  "id_doc_type": "PASSPORT",
  "id_doc_front_file": "https://example.com/image.png",
  "id_doc_back_file": "https://example.com/image.png",
  "legal_name": "Company Name Inc.",
  "alternate_name": "Company Name Inc.",
  "website": "https://example.com",
  "owners": [
    {
      "id": "ub_000000000000",
      "first_name": "John",
      "last_name": "Doe",
      "address_line_1": "738 Plain St",
      "address_line_2": "Building 22",
      "city": "Marshfield",
      "state_province_region": "MA",
      "country": "US",
      "postal_code": "02050",
      "id_doc_country": "BR",
      "id_doc_type": "PASSPORT",
      "id_doc_front_file": "https://example.com/image.png",
      "id_doc_back_file": "https://example.com/image.png"
    }
  ],
  "incorporation_doc_file": "https://example.com/image.png",
  "proof_of_ownership_doc_file": "https://example.com/image.png",
  "source_of_funds_doc_type": "business_income",
  "source_of_funds_doc_file": "https://example.com/image.png",
  "selfie_file": "https://example.com/image.png",
  "purpose_of_transactions": "business_transactions",
  "purpose_of_transactions_explanation": "I am a business owner and I want to receive payments from my customers",
  "account_purpose": "treasury_management",
  "account_purpose_other": "Custom account purpose description",
  "business_type": "llc",
  "business_description": "Software development company",
  "business_industry": "541511",
  "estimated_annual_revenue": "1000000_9999999",
  "source_of_wealth": "affiliate_or_royalty_income",
  "occupation": "Software Engineer",
  "external_id": "your_company_external_id",
  "instance_id": "in_000000000000",
  "tos_id": "to_000000000000",
  "aml_status": "clear",
  "aml_hits": {
    "has_sanction_match": false,
    "has_pep_match": false,
    "has_watchlist_match": false,
    "has_crimelist_match": false,
    "has_adversemedia_match": false
  },
  "created_at": "2021-01-01T00:00:00Z",
  "updated_at": "2021-01-01T00:00:00Z",
  "limit": {
    "per_transaction": 100000,
    "daily": 200000,
    "monthly": 1000000
  },
  "additional_info": [
    {
      "label": "EIN_LETTER",
      "value": "https://example.com/ein.pdf"
    },
    {
      "label": "FLOW_OF_FUNDS",
      "value": "Funds originate from US payroll deposits, forwarded weekly to customer."
    }
  ],
  "virtual_account_preapproval": {
    "status": "approved",
    "banking_partners": [
      "jpmorgan"
    ],
    "reviewed_at": "2026-09-01T00:00:00.000Z"
  }
}

Changes

Oct 15, 20265e4f8b62871c Revision changes
- info
  added the optional property to the response with the status
Oct 13, 2026adcb6ec97ccb Revision changes
- info
  removed the 111998 enum value from the response property for the response status
- info
  removed the 112120 enum value from the response property for the response status
- info
  removed the 113310 enum value from the response property for the response status
- info
  removed the 115114 enum value from the response property for the response status
- info
  removed the 211120 enum value from the response property for the response status
- info
  removed the 212114 enum value from the response property for the response status
- info
  removed the 213112 enum value from the response property for the response status
- info
  removed the 221310 enum value from the response property for the response status
- info
  removed the 236115 enum value from the response property for the response status
- info
  removed the 236220 enum value from the response property for the response status
- info
  removed the 237310 enum value from the response property for the response status
- info
  removed the 238210 enum value from the response property for the response status
- info
  removed the 311421 enum value from the response property for the response status
- info
  removed the 312130 enum value from the response property for the response status
- info
  removed the 313110 enum value from the response property for the response status
- info
  removed the 315990 enum value from the response property for the response status
- info
  removed the 322220 enum value from the response property for the response status
- info
  removed the 325412 enum value from the response property for the response status
- info
  removed the 334111 enum value from the response property for the response status
- info
  removed the 334118 enum value from the response property for the response status
- info
  removed the 334210 enum value from the response property for the response status
- info
  removed the 336110 enum value from the response property for the response status
- info
  removed the 336390 enum value from the response property for the response status
- info
  removed the 337121 enum value from the response property for the response status
- info
  removed the 339112 enum value from the response property for the response status
- info
  removed the 339910 enum value from the response property for the response status
- info
  removed the 339920 enum value from the response property for the response status
- info
  removed the 339930 enum value from the response property for the response status
- info
  removed the 423110 enum value from the response property for the response status
- info
  removed the 423430 enum value from the response property for the response status
- info
  removed the 423510 enum value from the response property for the response status
- info
  removed the 423690 enum value from the response property for the response status
- info
  removed the 423830 enum value from the response property for the response status
- info
  removed the 423840 enum value from the response property for the response status
- info
  removed the 423940 enum value from the response property for the response status
- info
  removed the 424210 enum value from the response property for the response status
- info
  removed the 424410 enum value from the response property for the response status
- info
  removed the 424480 enum value from the response property for the response status
- info
  removed the 424690 enum value from the response property for the response status
- info
  removed the 424990 enum value from the response property for the response status
- info
  removed the 444110 enum value from the response property for the response status
- info
  removed the 445110 enum value from the response property for the response status
- info
  removed the 445320 enum value from the response property for the response status
- info
  removed the 446120 enum value from the response property for the response status
- info
  removed the 449210 enum value from the response property for the response status
- info
  removed the 454110 enum value from the response property for the response status
- info
  removed the 455110 enum value from the response property for the response status
- info
  removed the 455219 enum value from the response property for the response status
- info
  removed the 456110 enum value from the response property for the response status
- info
  removed the 456120 enum value from the response property for the response status
- info
  removed the 457110 enum value from the response property for the response status
- info
  removed the 458110 enum value from the response property for the response status
- info
  removed the 458210 enum value from the response property for the response status
- info
  removed the 458310 enum value from the response property for the response status
- info
  removed the 459120 enum value from the response property for the response status
- info
  removed the 459210 enum value from the response property for the response status
- info
  removed the 481111 enum value from the response property for the response status
- info
  removed the 483111 enum value from the response property for the response status
- info
  removed the 484121 enum value from the response property for the response status
- info
  removed the 485210 enum value from the response property for the response status
- info
  removed the 488510 enum value from the response property for the response status
- info
  removed the 493110 enum value from the response property for the response status
- info
  removed the 511210 enum value from the response property for the response status
- info
  removed the 512250 enum value from the response property for the response status
- info
  removed the 513130 enum value from the response property for the response status
- info
  removed the 513210 enum value from the response property for the response status
- info
  removed the 516120 enum value from the response property for the response status
- info
  removed the 517111 enum value from the response property for the response status
- info
  removed the 517112 enum value from the response property for the response status
- info
  removed the 517410 enum value from the response property for the response status
- info
  removed the 518210 enum value from the response property for the response status
- info
  removed the 519130 enum value from the response property for the response status
- info
  removed the 519290 enum value from the response property for the response status
- info
  removed the 522110 enum value from the response property for the response status
- info
  removed the 522210 enum value from the response property for the response status
- info
  removed the 522320 enum value from the response property for the response status
- info
  removed the 523150 enum value from the response property for the response status
- info
  removed the 523940 enum value from the response property for the response status
- info
  removed the 523999 enum value from the response property for the response status
- info
  removed the 524113 enum value from the response property for the response status
- info
  removed the 531110 enum value from the response property for the response status
- info
  removed the 531120 enum value from the response property for the response status
- info
  removed the 531130 enum value from the response property for the response status
- info
  removed the 531190 enum value from the response property for the response status
- info
  removed the 531210 enum value from the response property for the response status
- info
  removed the 531311 enum value from the response property for the response status
- info
  removed the 531312 enum value from the response property for the response status
- info
  removed the 531320 enum value from the response property for the response status
- info
  removed the 531390 enum value from the response property for the response status
- info
  removed the 532111 enum value from the response property for the response status
- info
  removed the 541110 enum value from the response property for the response status
- info
  removed the 541211 enum value from the response property for the response status
- info
  removed the 541213 enum value from the response property for the response status
- info
  removed the 541214 enum value from the response property for the response status
- info
  removed the 541219 enum value from the response property for the response status
- info
  removed the 541330 enum value from the response property for the response status
- info
  removed the 541430 enum value from the response property for the response status
- info
  removed the 541511 enum value from the response property for the response status
- info
  removed the 541512 enum value from the response property for the response status
- info
  removed the 541519 enum value from the response property for the response status
- info
  removed the 541611 enum value from the response property for the response status
- info
  removed the 541618 enum value from the response property for the response status
- info
  removed the 541715 enum value from the response property for the response status
- info
  removed the 541810 enum value from the response property for the response status
- info
  removed the 541922 enum value from the response property for the response status
- info
  removed the 541930 enum value from the response property for the response status
- info
  removed the 541940 enum value from the response property for the response status
- info
  removed the 541990 enum value from the response property for the response status
- info
  removed the 551112 enum value from the response property for the response status
- info
  removed the 561311 enum value from the response property for the response status
- info
  removed the 561422 enum value from the response property for the response status
- info
  removed the 561499 enum value from the response property for the response status
- info
  removed the 561510 enum value from the response property for the response status
- info
  removed the 561612 enum value from the response property for the response status
- info
  removed the 561730 enum value from the response property for the response status
- info
  removed the 561740 enum value from the response property for the response status
- info
  removed the 562111 enum value from the response property for the response status
- info
  removed the 562920 enum value from the response property for the response status
- info
  removed the 611110 enum value from the response property for the response status
- info
  removed the 611310 enum value from the response property for the response status
- info
  removed the 611410 enum value from the response property for the response status
- info
  removed the 611710 enum value from the response property for the response status
- info
  removed the 621111 enum value from the response property for the response status
- info
  removed the 621210 enum value from the response property for the response status
- info
  removed the 621399 enum value from the response property for the response status
- info
  removed the 621511 enum value from the response property for the response status
- info
  removed the 621910 enum value from the response property for the response status
- info
  removed the 622110 enum value from the response property for the response status
- info
  removed the 623110 enum value from the response property for the response status
- info
  removed the 623220 enum value from the response property for the response status
- info
  removed the 624410 enum value from the response property for the response status
- info
  removed the 711110 enum value from the response property for the response status
- info
  removed the 711211 enum value from the response property for the response status
- info
  removed the 711410 enum value from the response property for the response status
- info
  removed the 711510 enum value from the response property for the response status
- info
  removed the 712110 enum value from the response property for the response status
- info
  removed the 713110 enum value from the response property for the response status
- info
  removed the 713210 enum value from the response property for the response status
- info
  removed the 721110 enum value from the response property for the response status
- info
  removed the 722511 enum value from the response property for the response status
- info
  removed the 722513 enum value from the response property for the response status
- info
  removed the 811111 enum value from the response property for the response status
- info
  removed the 811210 enum value from the response property for the response status
- info
  removed the 812111 enum value from the response property for the response status
- info
  removed the 812112 enum value from the response property for the response status
- info
  removed the 812199 enum value from the response property for the response status
- info
  removed the 813110 enum value from the response property for the response status
- info
  removed the 813211 enum value from the response property for the response status
- info
  removed the 813219 enum value from the response property for the response status

Operation history (6 revisions)