Get customers

GET

customers

take

number

skip

number

string

id__not

string

id__isNull

string

id__isNotNull

string

id__equals

string

id__contains

string

id__startsWith

string

id__endWith

string

name

string

name__not

string

name__isNull

string

name__isNotNull

string

name__equals

string

name__contains

string

name__startsWith

string

name__endWith

string

type

string

type__not

string

type__isNull

string

type__isNotNull

string

type__equals

string

type__contains

string

type__startsWith

string

type__endWith

string

status

enum<string>

status__in

enum<string>

status__notIn

enum<string>

currency

string

currency__not

string

currency__isNull

string

currency__isNotNull

string

currency__equals

string

currency__contains

string

currency__startsWith

string

currency__endWith

string

country

string

country__not

string

country__isNull

string

country__isNotNull

string

country__equals

string

country__contains

string

country__startsWith

string

country__endWith

string

vat_number

string

vat_number__not

string

vat_number__isNull

string

vat_number__isNotNull

string

vat_number__equals

string

vat_number__contains

string

vat_number__startsWith

string

vat_number__endWith

string

external_id

string

external_id__not

string

external_id__isNull

string

external_id__isNotNull

string

external_id__equals

string

external_id__contains

string

external_id__startsWith

string

external_id__endWith

string

billing_email

string

billing_email__not

string

billing_email__isNull

string

billing_email__isNotNull

string

billing_email__equals

string

billing_email__contains

string

billing_email__startsWith

string

billing_email__endWith

string

paymentMethodType

enum<string>

paymentMethodType__in

enum<string>

paymentMethodType__notIn

enum<string>

subscriptionStatus

enum<string>

subscriptionStatus__in

enum<string>

subscriptionStatus__notIn

enum<string>

created_at

string

created_at__not

string

created_at__isNull

string

created_at__isNotNull

string

created_at__equals

string

created_at__lt

string

created_at__lte

string

created_at__gt

string

created_at__gte

string

deleted_at

string

deleted_at__not

string

deleted_at__isNull

string

deleted_at__isNotNull

string

deleted_at__equals

string

deleted_at__lt

string

deleted_at__lte

string

deleted_at__gt

string

deleted_at__gte

string

curl --request GET \
  --url https://api.hyperline.co/v1/customers \
  --header 'Authorization: Bearer <token>'

{
  "meta": {
    "total": 1,
    "taken": 1,
    "skipped": 123
  },
  "data": [
    {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "type": "corporate",
      "status": "active",
      "currency": "EUR",
      "country": "FR",
      "vat_number": "FR123456789",
      "vat_number_valid": true,
      "vat_rate_custom": 123,
      "language": "fr",
      "external_id": "<string>",
      "properties": "<string>",
      "custom_properties": {},
      "billing_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": "<string>",
        "city": "Paris",
        "zip": "75010",
        "state": "<string>",
        "country": "FR"
      },
      "billing_email": "billing@acme.com",
      "invoice_emails": [
        "accounting@acme.com"
      ],
      "invoicing_entity_id": "ive_484dn4U48E",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "current_payment_method_type": "card",
      "current_payment_method_id": "pm_UTclbc1US8GzCe",
      "transaction_provider_id": "<string>",
      "subscriptions": [
        {
          "id": "sub_0kIc7jrF7gV00V",
          "status": "active",
          "current_period_started_at": "2023-10-12T07:00:01.860Z",
          "current_period_ends_at": "2023-11-12T07:00:01.860Z",
          "plan_id": "plan_34hdd843hReh",
          "checkout_session_id": "che_949djdj39RJj"
        }
      ],
      "created_at": "2023-10-12T07:00:01.860Z",
      "updated_at": "2023-10-12T07:00:01.860Z",
      "deleted_at": "2023-11-07T05:31:56Z"
    }
  ]
}

Authorizations

Authorization

string

headerrequired

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

take

number | null

default: 50

skip

number | null

default: 0

string

id__not

string

id__isNull

string

id__isNotNull

string

id__equals

string

id__contains

string

id__startsWith

string

id__endWith

string

name

string

name__not

string

name__isNull

string

name__isNotNull

string

name__equals

string

name__contains

string

name__startsWith

string

name__endWith

string

type

string

type__not

string

type__isNull

string

type__isNotNull

string

type__equals

string

type__contains

string

type__startsWith

string

type__endWith

string

status

Available options:

all,

active,

inactive,

imported,

archived

status__in

Available options:

all,

active,

inactive,

imported,

archived

status__notIn

Available options:

all,

active,

inactive,

imported,

archived

currency

string

currency__not

string

currency__isNull

string

currency__isNotNull

string

currency__equals

string

currency__contains

string

currency__startsWith

string

currency__endWith

string

country

string

country__not

string

country__isNull

string

country__isNotNull

string

country__equals

string

country__contains

string

country__startsWith

string

country__endWith

string

vat_number

string

vat_number__not

string

vat_number__isNull

string

vat_number__isNotNull

string

vat_number__equals

string

vat_number__contains

string

vat_number__startsWith

string

vat_number__endWith

string

external_id

string

external_id__not

string

external_id__isNull

string

external_id__isNotNull

string

external_id__equals

string

external_id__contains

string

external_id__startsWith

string

external_id__endWith

string

billing_email

string

billing_email__not

string

billing_email__isNull

string

billing_email__isNotNull

string

billing_email__equals

string

billing_email__contains

string

billing_email__startsWith

string

billing_email__endWith

string

paymentMethodType

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

external,

missing

paymentMethodType__in

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

external,

missing

paymentMethodType__notIn

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

external,

missing

subscriptionStatus

Available options:

active,

pending,

cancelled,

paused,

trialing,

errored,

draft,

none

subscriptionStatus__in

Available options:

active,

pending,

cancelled,

paused,

trialing,

errored,

draft,

none

subscriptionStatus__notIn

Available options:

active,

pending,

cancelled,

paused,

trialing,

errored,

draft,

none

created_at

string

created_at__not

string

created_at__isNull

string

created_at__isNotNull

string

created_at__equals

string

created_at__lt

string

created_at__lte

string

created_at__gt

string

created_at__gte

string

deleted_at

string

deleted_at__not

string

deleted_at__isNull

string

deleted_at__isNotNull

string

deleted_at__equals

string

deleted_at__lt

string

deleted_at__lte

string

deleted_at__gt

string

deleted_at__gte

string

Response

200 - application/json

meta

object

required

data

object[]

required

List of Customer.

data.id

string

required

Customer ID.

data.name

string

required

Customer legal name.

data.type

enum<string> | null

required

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.

Available options:

corporate,

person,

automatically_created

data.status

enum<string>

required

Customer status.

Available options:

active,

archived

data.currency

string

required

Currency code. See ISO 4217.

data.country

string | null

required

Two-letter country code in ISO format. See ISO 3166 Alpha 2.

data.vat_number

string | null

required

Customer tax number.

data.vat_number_valid

boolean

required

Indicates customer's tax number validity.

data.vat_rate_custom

number | null

required

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.

data.language

enum<string> | null

required

Language use to translate invoices and emails

Available options:

fr,

en,

de,

it,

nl

data.external_id

string | null

required

ID of the customer in your system. This helps matching your customer with the one on Hyperline.

data.properties

required

Key/value pairs to store any information you find useful.

data.custom_properties

object | null

required

A list of key value with the ID or the name of the custom property as the key and the custom property value as value.

data.billing_address

object

required

Company billing address

data.billing_email

string | null

required

Email to which all communications will be sent.

data.invoice_emails

string[]

required

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.

data.invoicing_entity_id

string

required

ID of the invoicing entity this customer will be attached to.

data.available_payment_methods

enum<string>[]

required

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.

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

transfer_automated

data.current_payment_method_type

enum<string> | null

required

Default payment method type used to pay subscriptions and one-off invoices.

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

transfer_automated,

external

data.current_payment_method_id

string | null

required

ID of the default payment method of the customer. Only applies to card and direct debit.

data.transaction_provider_id

string | null

required

Deprecated field, please use providers.

data.subscriptions

object[]

required

data.created_at

string

required

UTC date time string in the ISO 8601 format.

data.updated_at

string

required

UTC date time string in the ISO 8601 format.

data.deleted_at

string | null

required

UTC date time string in the ISO 8601 format.

Delete custom property Create customer

curl --request GET \
  --url https://api.hyperline.co/v1/customers \
  --header 'Authorization: Bearer <token>'

{
  "meta": {
    "total": 1,
    "taken": 1,
    "skipped": 123
  },
  "data": [
    {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "type": "corporate",
      "status": "active",
      "currency": "EUR",
      "country": "FR",
      "vat_number": "FR123456789",
      "vat_number_valid": true,
      "vat_rate_custom": 123,
      "language": "fr",
      "external_id": "<string>",
      "properties": "<string>",
      "custom_properties": {},
      "billing_address": {
        "name": "Acme",
        "line1": "5 rue de Paradis",
        "line2": "<string>",
        "city": "Paris",
        "zip": "75010",
        "state": "<string>",
        "country": "FR"
      },
      "billing_email": "billing@acme.com",
      "invoice_emails": [
        "accounting@acme.com"
      ],
      "invoicing_entity_id": "ive_484dn4U48E",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "current_payment_method_type": "card",
      "current_payment_method_id": "pm_UTclbc1US8GzCe",
      "transaction_provider_id": "<string>",
      "subscriptions": [
        {
          "id": "sub_0kIc7jrF7gV00V",
          "status": "active",
          "current_period_started_at": "2023-10-12T07:00:01.860Z",
          "current_period_ends_at": "2023-11-12T07:00:01.860Z",
          "plan_id": "plan_34hdd843hReh",
          "checkout_session_id": "che_949djdj39RJj"
        }
      ],
      "created_at": "2023-10-12T07:00:01.860Z",
      "updated_at": "2023-10-12T07:00:01.860Z",
      "deleted_at": "2023-11-07T05:31:56Z"
    }
  ]
}

API documentation

Integrations

Analytics

Billable events

Companies

Coupons

Custom properties

Customers

Customers > Credits

Integrations

Invoices

Invoicing entities

OAuth2

Payments

Plans

Price configurations

Products

Quotes

Subscriptions

Third-party apps

Wallets

Webhooks

Authorizations

Query Parameters

Response