GET
/
v1
/
businesses
/
{business_id}
/
customers
curl -X GET https://sandbox.layerfi.com/v1/businesses/${business_id}/customers/ \
  -H "Authorization: Bearer <access_token>" \
{
  "data": [
    {
      "external_id": "customer-1",
      "individual_name": "John Doe",
      "company_name": "Acme, Inc.",
      "email": "john@hotmail.com",
      "mobile_phone": "555-555-5555",
      "office_phone": "555-555-5555",
      "address_string": "123 Main St, Phoenix, AZ 85001",
      "notes": "This is a note"
    },
    {
      "external_id": "customer-2",
      "individual_name": "Jane Doe",
      "company_name": "MegaCorp",
      "email": "jane@hotmail.com"
    }
  ]
}

The GET endpoint lists all created customers within Layer. Only active customers are returned by default, but archived customers can be included via the include_archived flag.

Path Parameters

business_id
string
required

ID of the Business the customer is associated with.

Query Parameters

include_archived
boolean

Include archived customers in the response. Defaults to false.

Response

Returns a list of Customer objects

curl -X GET https://sandbox.layerfi.com/v1/businesses/${business_id}/customers/ \
  -H "Authorization: Bearer <access_token>" \
{
  "data": [
    {
      "external_id": "customer-1",
      "individual_name": "John Doe",
      "company_name": "Acme, Inc.",
      "email": "john@hotmail.com",
      "mobile_phone": "555-555-5555",
      "office_phone": "555-555-5555",
      "address_string": "123 Main St, Phoenix, AZ 85001",
      "notes": "This is a note"
    },
    {
      "external_id": "customer-2",
      "individual_name": "Jane Doe",
      "company_name": "MegaCorp",
      "email": "jane@hotmail.com"
    }
  ]
}