List customers

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

import requests

url = "https://api.hyperline.co/v2/customers"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.hyperline.co/v2/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperline.co/v2/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperline.co/v2/customers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hyperline.co/v2/customers")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperline.co/v2/customers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "data": [
    {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "type": "corporate",
      "status": "active",
      "currency": "EUR",
      "country": "FR",
      "domain": "acme.com",
      "tax_ids": [
        {
          "value": "FR123456789",
          "status": "valid"
        }
      ],
      "tax_rate_custom": 50,
      "taxability": "taxable",
      "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": "billing@acme.com",
      "invoice_emails": [
        "accounting@acme.com"
      ],
      "invoicing_entity_id": "ive_484dn4U48E",
      "invoice_reminders_enabled": true,
      "price_book_id": "prib_613_WbVIZ1329e",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "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"
        }
      ],
      "segment_ids": [
        "seg_0kIc7jrF7gV00V"
      ],
      "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,
      "owner_id": "usr_KMcxRWc1ZQwvJG",
      "owner": {
        "id": "usr_KMcxRWc1ZQwvJG",
        "email": "owner@acme.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "picture_url": null
      },
      "followers": [
        {
          "id": "usr_KMcxRWc1ZQwvJG",
          "email": "owner@acme.com",
          "first_name": "Ada",
          "last_name": "Lovelace",
          "picture_url": null
        }
      ],
      "payment_terms": 30,
      "payment_initiation_delay": 7,
      "payment_method_type": "card",
      "payment_method_id": "pm_UTclbc1US8GzCe"
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "total": 1
}

GET

customers

List customers

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

import requests

url = "https://api.hyperline.co/v2/customers"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.hyperline.co/v2/customers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hyperline.co/v2/customers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hyperline.co/v2/customers"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.hyperline.co/v2/customers")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.hyperline.co/v2/customers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "data": [
    {
      "id": "cus_Typ0px2W0aiEtl",
      "name": "Acme",
      "type": "corporate",
      "status": "active",
      "currency": "EUR",
      "country": "FR",
      "domain": "acme.com",
      "tax_ids": [
        {
          "value": "FR123456789",
          "status": "valid"
        }
      ],
      "tax_rate_custom": 50,
      "taxability": "taxable",
      "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": "billing@acme.com",
      "invoice_emails": [
        "accounting@acme.com"
      ],
      "invoicing_entity_id": "ive_484dn4U48E",
      "invoice_reminders_enabled": true,
      "price_book_id": "prib_613_WbVIZ1329e",
      "available_payment_methods": [
        "card",
        "direct_debit"
      ],
      "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"
        }
      ],
      "segment_ids": [
        "seg_0kIc7jrF7gV00V"
      ],
      "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,
      "owner_id": "usr_KMcxRWc1ZQwvJG",
      "owner": {
        "id": "usr_KMcxRWc1ZQwvJG",
        "email": "owner@acme.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "picture_url": null
      },
      "followers": [
        {
          "id": "usr_KMcxRWc1ZQwvJG",
          "email": "owner@acme.com",
          "first_name": "Ada",
          "last_name": "Lovelace",
          "picture_url": null
        }
      ],
      "payment_terms": 30,
      "payment_initiation_delay": 7,
      "payment_method_type": "card",
      "payment_method_id": "pm_UTclbc1US8GzCe"
    }
  ],
  "next_cursor": null,
  "has_more": false,
  "total": 1
}

Authorizations

Authorization

string

header

required

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

Query Parameters

limit

number

default:50

Maximum number of items to return (1-100).

Required range: x <= 100

Example:

50

cursor

string

Opaque cursor returned in the previous response's next_cursor. Omit to fetch the first page.

include_total

default:false

Set to true to include total in the response.

Example:

false

order

enum<string>

default:desc

Sort direction.

Available options:

asc,

desc

Example:

"desc"

sort

enum<string>

Field used to sort the results.

Available options:

created_at,

updated_at

name

string

name__not

string

name__isNull

string

name__isNotNull

string

name__equals

string

name__contains

string

name__startsWith

string

name__endWith

string

type

Available options:

corporate,

person

type__in

Available options:

corporate,

person

status

Available options:

all,

active,

inactive,

imported,

archived

status__in

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

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

tax_id

string

tax_id__not

string

tax_id__isNull

string

tax_id__isNotNull

string

tax_id__equals

string

tax_id__contains

string

tax_id__startsWith

string

tax_id__endWith

string

subscription_status

Available options:

active,

pending,

cancelled,

paused,

trialing,

errored,

draft,

none

subscription_status__in

Available options:

active,

pending,

cancelled,

paused,

trialing,

errored,

draft,

none

invoicing_entity_id

string

invoicing_entity_id__not

string

invoicing_entity_id__isNull

string

invoicing_entity_id__isNotNull

string

invoicing_entity_id__equals

string

invoicing_entity_id__contains

string

invoicing_entity_id__startsWith

string

invoicing_entity_id__endWith

string

segment_id

string

custom_properties

string

payment_method_type

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

external,

missing,

errored

payment_method_type__in

Available options:

card,

direct_debit,

direct_debit_ach,

direct_debit_bacs,

transfer,

external,

missing,

errored

integration_entity_id

string

created_at

string<date-time>

created_at__not

string<date-time>

created_at__isNull

string<date-time>

created_at__isNotNull

string<date-time>

created_at__equals

string<date-time>

created_at__lt

string<date-time>

created_at__lte

string<date-time>

created_at__gt

string<date-time>

created_at__gte

string<date-time>

updated_at

string<date-time>

updated_at__not

string<date-time>

updated_at__isNull

string<date-time>

updated_at__isNotNull

string<date-time>

updated_at__equals

string<date-time>

updated_at__lt

string<date-time>

updated_at__lte

string<date-time>

updated_at__gt

string<date-time>

updated_at__gte

string<date-time>

Response

200 - application/json

data

object[]

required

List of Customer.

Show child attributes

next_cursor

string | null

required

Cursor to fetch the next page. null when there are no more items.

Example:

null

has_more

boolean

required

Whether more items are available after this page.

Example:

false

total

number

Total number of items matching the filters. Only present when include_total=true was passed.

Example:

1

List customers

Create customer

⌘I