Get customer
We recommend using the GET /v2/customers/{id} endpoint instead.
Documentation Index
Fetch the complete documentation index at: https://docs.hyperline.co/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Response
Customer ID.
"cus_Typ0px2W0aiEtl"
Customer name.
"Acme"
Customer type.
corporate: The customer is a business entity.person: The customer is a natural person.automatically_created: The customer was automatically imported (e.g. from a data loader). This value cannot be used when creating/editing.
corporate, person, automatically_created "corporate"
Customer status.
active, archived "active"
Currency code. See ISO 4217.
EUR, AED, AFN, XCD, ALL, AMD, AOA, ARS, USD, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, XOF, BMD, BND, BOB, BRL, BSD, BTN, NOK, BWP, BYR, BZD, CAD, CDF, XAF, CHF, NZD, CLP, CNY, COP, CRC, CUP, CVE, ANG, CZK, DJF, DKK, DOP, DZD, EGP, MAD, ERN, ETB, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MDL, MGA, MKD, MMK, MNT, MOP, MRO, MUR, MVR, MWK, MXN, MYR, MZN, NAD, XPF, NGN, NIO, NPR, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STD, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, UYU, UZS, VEF, VND, VUV, WST, YER, ZAR, ZMW, ZWL "EUR"
Two-letter country code in ISO format. See ISO 3166-1 alpha-2.
AD, AE, AF, AG, AI, AL, AM, AO, AQ, AR, AS, AT, AU, AW, AX, AZ, BA, BB, BD, BE, BG, BH, BI, BJ, BL, BM, BN, BO, BQ, BR, BS, BT, BF, BV, BW, BY, BZ, CA, CC, CD, CF, CG, CH, CI, CK, CL, CM, CN, CO, CR, CU, CV, CW, CX, CY, CZ, DE, DJ, DK, DM, DO, DZ, EC, EE, EG, EH, ER, ES, ET, FI, FJ, FK, FM, FO, FR, GA, GB, GD, GE, GF, GG, GH, GI, GL, GM, GN, GP, GQ, GR, GS, GT, GU, GW, GY, HK, HM, HN, HR, HT, HU, IC, ID, IE, IL, IM, IN, IO, IQ, IR, IS, IT, JE, JM, JO, JP, KE, KG, KH, KI, KM, KN, KP, KR, KW, KY, KZ, LA, LB, LC, LI, LK, LR, LS, LT, LU, LV, LY, MA, MC, MD, ME, MF, MG, MH, MK, ML, MM, MN, MO, MP, MQ, MR, MS, MT, MU, MV, MW, MX, MY, MZ, NA, NC, NE, NF, NG, NI, NL, NO, NP, NR, NU, NZ, OM, PA, PE, PF, PG, PH, PK, PL, PM, PN, PR, PS, PT, PT-20, PT-30, PW, PY, QA, RE, RO, RS, RU, RW, SA, SB, SC, SD, SE, SG, SH, SI, SJ, SK, SL, SM, SN, SO, SR, SS, ST, SV, SX, SY, SZ, TC, TD, TF, TG, TH, TJ, TK, TL, TM, TN, TO, TR, TT, TV, TW, TZ, UA, UG, UM, US, UY, UZ, VA, VC, VE, VG, VI, VN, VU, WF, WS, XK, YE, YT, ZA, ZM, ZW "FR"
Deprecated field, please use tax_ids.
Deprecated field, please use tax_ids.
Deprecated field, please use tax_rate_custom.
Customer tax IDs.
Customer custom tax rate. If not defined, the rate will be automatically determined based on the customer's country, your country, and applicable legal requirements.
0 <= x <= 100Customer registration number.
"36252187900034"
Indicates if the customer is affiliated with a government entity.
false
Language used for invoices, emails, and hosted pages.
fr, en, de, it, nl, es, pt, pl "fr"
Customer timezone.
Pacific/Midway, Pacific/Pago_Pago, Pacific/Niue, Pacific/Rarotonga, Pacific/Honolulu, Pacific/Tahiti, Pacific/Marquesas, Pacific/Gambier, America/Adak, America/Anchorage, Pacific/Pitcairn, America/Hermosillo, America/Phoenix, America/Los_Angeles, America/Tijuana, America/Vancouver, America/Whitehorse, America/Belize, America/Guatemala, America/Managua, America/Mexico_City, America/Costa_Rica, America/El_Salvador, America/Regina, America/Tegucigalpa, Pacific/Easter, Pacific/Galapagos, America/Edmonton, America/Ciudad_Juarez, America/Denver, America/Rio_Branco, America/Chicago, America/Matamoros, America/Winnipeg, America/Bogota, America/Atikokan, America/Cancun, America/Cayman, America/Jamaica, America/Panama, America/Guayaquil, America/Lima, America/Manaus, America/St_Kitts, America/Blanc-Sablon, America/Montserrat, America/Barbados, America/Port_of_Spain, America/Martinique, America/St_Lucia, America/St_Barthelemy, America/St_Vincent, America/Kralendijk, America/Guadeloupe, America/Marigot, America/Aruba, America/Lower_Princes, America/Tortola, America/Dominica, America/St_Thomas, America/Grenada, America/Antigua, America/Puerto_Rico, America/Santo_Domingo, America/Anguilla, America/Curacao, America/La_Paz, America/Santiago, America/Havana, America/Nassau, America/New_York, America/Port-au-Prince, America/Grand_Turk, America/Toronto, America/Guyana, America/Caracas, America/Argentina/Buenos_Aires, America/Halifax, Atlantic/Bermuda, America/Thule, America/Sao_Paulo, Antarctica/Palmer, America/Punta_Arenas, Atlantic/Stanley, America/Cayenne, America/Asuncion, America/Paramaribo, America/Montevideo, America/St_Johns, America/Noronha, Atlantic/South_Georgia, America/Miquelon, Atlantic/Cape_Verde, America/Nuuk, Atlantic/Azores, Etc/UTC, Africa/Abidjan, Africa/Bamako, Africa/Bissau, Africa/Conakry, Africa/Dakar, America/Danmarkshavn, Africa/Freetown, Atlantic/St_Helena, Africa/Accra, Africa/Lome, Africa/Monrovia, Africa/Nouakchott, Africa/Ouagadougou, Atlantic/Reykjavik, Africa/Sao_Tome, Africa/Banjul, Africa/Algiers, Africa/Tunis, Europe/Isle_of_Man, Europe/Dublin, Europe/London, Europe/Jersey, Europe/Guernsey, Africa/Bangui, Africa/Malabo, Africa/Brazzaville, Africa/Porto-Novo, Africa/Douala, Africa/Kinshasa, Africa/Lagos, Africa/Libreville, Africa/Luanda, Africa/Ndjamena, Africa/Niamey, Africa/Casablanca, Africa/El_Aaiun, Atlantic/Canary, Europe/Lisbon, Atlantic/Faroe, Africa/Bujumbura, Africa/Gaborone, Africa/Harare, Africa/Juba, Africa/Khartoum, Africa/Kigali, Africa/Blantyre, Africa/Lubumbashi, Africa/Lusaka, Africa/Maputo, Africa/Windhoek, Europe/Andorra, Europe/Belgrade, Europe/Berlin, Europe/Bratislava, Europe/Brussels, Europe/Budapest, Europe/Copenhagen, Europe/Gibraltar, Europe/Ljubljana, Arctic/Longyearbyen, Europe/Luxembourg, Europe/Madrid, Europe/Monaco, Europe/Oslo, Europe/Paris, Europe/Podgorica, Europe/Prague, Europe/Rome, Europe/Amsterdam, Europe/San_Marino, Europe/Malta, Europe/Sarajevo, Europe/Skopje, Europe/Stockholm, Europe/Tirane, Europe/Vaduz, Europe/Vatican, Europe/Vienna, Europe/Warsaw, Europe/Zagreb, Europe/Zurich, Europe/Kaliningrad, Africa/Tripoli, Antarctica/Troll, Africa/Johannesburg, Africa/Mbabane, Africa/Maseru, Asia/Kuwait, Asia/Bahrain, Asia/Baghdad, Asia/Qatar, Asia/Riyadh, Asia/Aden, Asia/Amman, Asia/Damascus, Africa/Addis_Ababa, Indian/Antananarivo, Africa/Asmara, Africa/Dar_es_Salaam, Africa/Djibouti, Africa/Kampala, Indian/Mayotte, Africa/Mogadishu, Indian/Comoro, Africa/Nairobi, Europe/Athens, Asia/Beirut, Europe/Bucharest, Africa/Cairo, Europe/Chisinau, Asia/Hebron, Europe/Helsinki, Europe/Kyiv, Europe/Mariehamn, Asia/Nicosia, Europe/Riga, Europe/Sofia, Europe/Tallinn, Europe/Vilnius, Asia/Jerusalem, Europe/Minsk, Europe/Moscow, Europe/Simferopol, Antarctica/Syowa, Europe/Istanbul, Asia/Tehran, Asia/Yerevan, Asia/Baku, Asia/Tbilisi, Asia/Dubai, Asia/Muscat, Indian/Mauritius, Indian/Reunion, Europe/Samara, Indian/Mahe, Asia/Kabul, Indian/Kerguelen, Asia/Almaty, Indian/Maldives, Antarctica/Mawson, Asia/Karachi, Asia/Dushanbe, Asia/Ashgabat, Asia/Tashkent, Asia/Yekaterinburg, Asia/Colombo, Asia/Kolkata, Asia/Kathmandu, Asia/Dhaka, Asia/Thimphu, Asia/Urumqi, Indian/Chagos, Asia/Bishkek, Asia/Omsk, Indian/Cocos, Asia/Yangon, Indian/Christmas, Antarctica/Davis, Asia/Hovd, Asia/Bangkok, Asia/Ho_Chi_Minh, Asia/Phnom_Penh, Asia/Vientiane, Asia/Novosibirsk, Asia/Jakarta, Antarctica/Casey, Australia/Perth, Asia/Brunei, Asia/Makassar, Asia/Macau, Asia/Shanghai, Asia/Hong_Kong, Asia/Irkutsk, Asia/Kuala_Lumpur, Asia/Manila, Asia/Singapore, Asia/Taipei, Asia/Ulaanbaatar, Australia/Eucla, Asia/Jayapura, Asia/Tokyo, Asia/Pyongyang, Asia/Seoul, Pacific/Palau, Asia/Dili, Asia/Chita, Australia/Adelaide, Australia/Darwin, Australia/Brisbane, Australia/Sydney, Pacific/Guam, Pacific/Saipan, Pacific/Chuuk, Antarctica/DumontDUrville, Pacific/Port_Moresby, Asia/Vladivostok, Australia/Lord_Howe, Pacific/Bougainville, Pacific/Kosrae, Pacific/Noumea, Pacific/Norfolk, Asia/Sakhalin, Pacific/Guadalcanal, Pacific/Efate, Pacific/Fiji, Pacific/Tarawa, Asia/Kamchatka, Pacific/Majuro, Pacific/Nauru, Pacific/Auckland, Antarctica/McMurdo, Pacific/Funafuti, Pacific/Wake, Pacific/Wallis, Pacific/Chatham, Pacific/Kanton, Pacific/Apia, Pacific/Fakaofo, Pacific/Tongatapu, Pacific/Kiritimati "Europe/Paris"
ID of the customer in your system. This helps matching your customer with the one on Hyperline.
null
Key/value pairs to store any metadata useful in your context.
null
A list of key value with the slug of the custom property as the key and the custom property value as value.
Customer billing address.
Customer shipping address.
Email to which all communications will be sent.
"billing@acme.com"
Emails to which invoices will be sent (e.g. payer, finance team, accounting firm). If not defined, invoices will be sent to the billing_email; otherwise, they won't be sent to the billing_email.
["accounting@acme.com"]ID of the invoicing entity this customer will be attached to.
"ive_484dn4U48E"
Indicates if invoice reminders are enabled for the customer.
Default price book ID assigned to the customer.
"prib_613_WbVIZ1329e"
List of payment methods you allow your customer to pay with. You customer will be able to select one of them in their portal page and those will be the default options when creating a checkout session.
card, apple_pay, google_pay, direct_debit, direct_debit_ach, direct_debit_bacs, stripe_link, transfer, transfer_automated ["card", "direct_debit"]Default payment method type used to pay subscriptions and one-off invoices.
card, apple_pay, google_pay, direct_debit, direct_debit_ach, direct_debit_bacs, stripe_link, transfer, transfer_automated, external "card"
ID of the default payment method of the customer. Only applies to card and direct debit.
"pm_UTclbc1US8GzCe"
Custom payment delay. If not defined, the default one defined on the related invoicing entity will be used.
30
Custom initiation delay for payment collection. If not defined, the default one defined on the related invoicing entity will be used.
7
IDs of segments this customer belongs to.
["seg_0kIc7jrF7gV00V"]Deprecated field, please use integrations.
Default payment method of the customer. Only applies to card and direct debit.
- Card
- Card (errored)
- Direct Debit
- Direct Debit (errored)
- Stripe Link
- Stripe Link (errored)
Custom bank account for the customer. If not defined and customer paying by bank transfer, the bank accounts configured in your account settings will be used.
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
- Option 19
- Option 20
- Option 21
- Option 22
- Option 23
- Option 24
- Option 25
- Option 26
- Option 27
- Option 28
- Option 29
- Option 30
- Option 31
- Option 32
- Option 33
- Option 34
- Option 35
- Option 36
- Option 37
- Option 38
- Option 39
- Option 40
- Option 41
- Option 42
- Option 43
- Option 44
- Option 45
- Option 46
- Option 47
- Option 48
- Option 49
- Option 50
- Option 51
- Option 52
- Option 53
- Option 54
- Option 55
- Option 56
- Option 57
- Option 58
- Option 59
- Option 60
- Option 61
- Option 62
- Option 63
- Option 64
{
"format": "iban_bic_swift",
"iban": "FR76XXXXXXXXXXXXXXXXXXXXXXX",
"bic_swift": "XXXXXXXX"
}Parent organization ID to which the client is attached.
null
How customer invoices are issued from the parent organisation.
none: Invoices will keep being issued from this customer.every_invoice: Customer invoices will be issued from the organisation individually.concat: Customer invoices will be grouped into a global parent invoice at a regular schedule (configured on the organisation).
none, every_invoice, concat null

