Skip to main content
PUT
/
v1
/
customers
/
{id}
/
archive
Archive customer
curl --request PUT \
  --url https://api.hyperline.co/v1/customers/{id}/archive \
  --header 'Authorization: Bearer <token>'
{
  "id": "cus_Typ0px2W0aiEtl",
  "name": "Acme",
  "type": "corporate",
  "status": "active",
  "currency": "EUR",
  "country": "FR",
  "vat_number": "FR123456789",
  "vat_number_valid": true,
  "vat_rate_custom": null,
  "registration_number": "36252187900034",
  "is_government_affiliated": false,
  "language": "fr",
  "timezone": "Europe/Paris",
  "external_id": null,
  "properties": null,
  "custom_properties": {},
  "billing_address": {
    "name": "Acme",
    "line1": "5 rue de Paradis",
    "line2": null,
    "city": "Paris",
    "zip": "75010",
    "state": "CA",
    "country": "FR"
  },
  "shipping_address": {
    "name": "Acme",
    "line1": "5 rue de Paradis",
    "line2": null,
    "city": "Paris",
    "zip": "75010",
    "state": "CA",
    "country": "FR"
  },
  "billing_email": "[email protected]",
  "invoice_emails": [
    "[email protected]"
  ],
  "invoicing_entity_id": "ive_484dn4U48E",
  "invoice_reminders_enabled": true,
  "price_book_id": "prib_613_WbVIZ1329e",
  "available_payment_methods": [
    "card",
    "direct_debit"
  ],
  "current_payment_method_type": "card",
  "current_payment_method_id": "pm_UTclbc1US8GzCe",
  "custom_payment_delay": 30,
  "subscriptions": [
    {
      "id": "sub_0kIc7jrF7gV00V",
      "status": "active",
      "current_period_started_at": "2024-10-12T07:00:01.860Z",
      "current_period_ends_at": "2024-11-12T07:00:01.860Z",
      "plan_id": "plan_34hdd843hReh",
      "checkout_session_id": "che_949djdj39RJj"
    }
  ],
  "integrations": [
    {
      "entity_id": "123456789",
      "provider_name": "stripe",
      "provider_account_id": "acc_1234567890"
    }
  ],
  "created_at": "2024-10-12T07:00:01.860Z",
  "updated_at": "2024-10-12T07:00:01.860Z",
  "deleted_at": null
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
id
string
required

Response

​
id
string
required
Example:
​
name
string
required
Example:
​
type
enum<string> | null
required
Available options:
corporate,
person,
automatically_created
Example:
​
status
enum<string>
required
Available options:
active,
archived
Example:
​
currency
enum<string> | null
required
Available options:
EUR,
AED,
AFN,
XCD,
ALL,
AMD,
AOA,
ARS,
USD,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
XOF,
BGN,
BHD,
BIF,
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
Example:
​
country
enum<string> | null
required
Available options:
AD,
AE,
AF,
AG,
AI,
AL,
AM,
AO,
AQ,
AR,
AS,
AT,
AU,
AW,
AX,
AZ,
BA,
BB,
BD,
BE,
BF,
BG,
BH,
BI,
BJ,
BL,
BM,
BN,
BO,
BQ,
BR,
BS,
BT,
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
Example:
​
vat_number
string | null
required
Example:
​
vat_number_valid
boolean
required
Example:
​
vat_rate_custom
number | null
required
Example:
​
registration_number
string | null
required
Example:
​
is_government_affiliated
boolean
required
Example:
​
language
enum<string> | null
required
Available options:
fr,
en,
de,
it,
nl,
es,
pt,
pl
Example:
​
timezone
enum<string> | null
required
Available options:
Pacific/Niue,
Pacific/Midway,
Pacific/Pago_Pago,
Pacific/Rarotonga,
America/Adak,
Pacific/Honolulu,
Pacific/Tahiti,
Pacific/Marquesas,
America/Anchorage,
Pacific/Gambier,
America/Los_Angeles,
America/Tijuana,
America/Vancouver,
Pacific/Pitcairn,
America/Hermosillo,
America/Edmonton,
America/Ciudad_Juarez,
America/Denver,
America/Phoenix,
America/Whitehorse,
America/Belize,
America/Chicago,
America/Guatemala,
America/Managua,
America/Mexico_City,
America/Matamoros,
America/Costa_Rica,
America/El_Salvador,
America/Regina,
America/Tegucigalpa,
America/Winnipeg,
Pacific/Galapagos,
America/Rio_Branco,
America/Bogota,
America/Havana,
Pacific/Easter,
America/Atikokan,
America/Cancun,
America/Grand_Turk,
America/Cayman,
America/Jamaica,
America/Nassau,
America/New_York,
America/Panama,
America/Port-au-Prince,
America/Toronto,
America/Guayaquil,
America/Lima,
America/Manaus,
America/St_Kitts,
America/Blanc-Sablon,
America/Montserrat,
America/Barbados,
America/St_Lucia,
America/Port_of_Spain,
America/Martinique,
America/St_Barthelemy,
America/Halifax,
Atlantic/Bermuda,
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/Thule,
America/Curacao,
America/La_Paz,
America/Guyana,
America/Caracas,
America/St_Johns,
America/Argentina/Buenos_Aires,
America/Sao_Paulo,
Antarctica/Palmer,
America/Punta_Arenas,
America/Santiago,
Atlantic/Stanley,
America/Cayenne,
America/Asuncion,
America/Miquelon,
America/Paramaribo,
America/Montevideo,
America/Scoresbysund,
America/Noronha,
Atlantic/South_Georgia,
America/Nuuk,
Atlantic/Azores,
Atlantic/Cape_Verde,
Etc/UTC,
Africa/Abidjan,
Africa/Bamako,
Africa/Bissau,
Africa/Conakry,
Africa/Dakar,
America/Danmarkshavn,
Europe/Isle_of_Man,
Europe/Dublin,
Africa/Freetown,
Atlantic/St_Helena,
Africa/Accra,
Africa/Lome,
Europe/London,
Africa/Monrovia,
Africa/Nouakchott,
Africa/Ouagadougou,
Atlantic/Reykjavik,
Europe/Jersey,
Europe/Guernsey,
Africa/Sao_Tome,
Africa/Banjul,
Antarctica/Troll,
Atlantic/Canary,
Europe/Lisbon,
Atlantic/Faroe,
Africa/Algiers,
Europe/Amsterdam,
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/San_Marino,
Europe/Malta,
Europe/Sarajevo,
Europe/Skopje,
Europe/Stockholm,
Europe/Tirane,
Africa/Tunis,
Europe/Vaduz,
Europe/Vatican,
Europe/Vienna,
Europe/Warsaw,
Europe/Zagreb,
Europe/Zurich,
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,
Africa/Bujumbura,
Africa/Gaborone,
Africa/Harare,
Africa/Juba,
Africa/Khartoum,
Africa/Kigali,
Africa/Blantyre,
Africa/Lubumbashi,
Africa/Lusaka,
Africa/Maputo,
Africa/Windhoek,
Europe/Athens,
Asia/Beirut,
Europe/Bucharest,
Africa/Cairo,
Europe/Chisinau,
Asia/Hebron,
Europe/Helsinki,
Europe/Kaliningrad,
Europe/Kyiv,
Europe/Mariehamn,
Asia/Nicosia,
Europe/Riga,
Europe/Sofia,
Europe/Tallinn,
Africa/Tripoli,
Europe/Vilnius,
Asia/Jerusalem,
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/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,
Asia/Almaty,
Indian/Kerguelen,
Indian/Maldives,
Antarctica/Mawson,
Asia/Karachi,
Asia/Dushanbe,
Asia/Ashgabat,
Asia/Tashkent,
Antarctica/Vostok,
Asia/Aqtobe,
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,
Australia/Perth,
Asia/Brunei,
Antarctica/Casey,
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/Dili,
Asia/Jayapura,
Asia/Tokyo,
Asia/Pyongyang,
Asia/Seoul,
Pacific/Palau,
Asia/Chita,
Australia/Darwin,
Australia/Brisbane,
Pacific/Guam,
Pacific/Saipan,
Pacific/Chuuk,
Antarctica/DumontDUrville,
Pacific/Port_Moresby,
Asia/Vladivostok,
Australia/Adelaide,
Australia/Sydney,
Pacific/Bougainville,
Pacific/Kosrae,
Australia/Lord_Howe,
Pacific/Noumea,
Asia/Sakhalin,
Pacific/Guadalcanal,
Pacific/Efate,
Pacific/Fiji,
Pacific/Tarawa,
Pacific/Majuro,
Pacific/Nauru,
Pacific/Norfolk,
Asia/Kamchatka,
Pacific/Funafuti,
Pacific/Wake,
Pacific/Wallis,
Pacific/Apia,
Pacific/Auckland,
Antarctica/McMurdo,
Pacific/Kanton,
Pacific/Fakaofo,
Pacific/Tongatapu,
Pacific/Chatham,
Pacific/Kiritimati
Example:
​
external_id
string | null
required
Example:
​
properties
object | null
required
Example:
​
custom_properties
object | null
required
​
billing_address
object
required
​
shipping_address
object | null
required
​
billing_email
string<email> | null
required
Example:
​
invoice_emails
string<email>[]
required
Example:
​
invoicing_entity_id
string
required
Example:
​
invoice_reminders_enabled
required
​
price_book_id
string | null
required
Example:
​
available_payment_methods
enum<string>[]
required
Example:
​
current_payment_method_type
enum<string> | null
required
Available options:
card,
apple_pay,
google_pay,
direct_debit,
direct_debit_ach,
direct_debit_bacs,
stripe_link,
transfer,
transfer_automated,
external
Example:
​
current_payment_method_id
string | null
required
Example:
​
custom_payment_delay
number | null
required
Example:
​
subscriptions
object[]
required
​
integrations
object[]
required
​
created_at
string<date-time>
required
Example:
​
updated_at
string<date-time>
required
Example:
​
deleted_at
string<date-time> | null
required
Example: