Skip to content

Get multiple customers

Get
bash
https://api.bunce.so/v1/customers

Returns a paginated list of customers. Use the query parameters to page through results.

Request

Query Parameters

per_page intSpecify how many records you want to retrieve per page. If not specify we use a default value of 20.
page intSpecify exactly what page you want to retrieve. If not specify we use a default value of 1.
query stringReturn entities that match a query parameter. Searches firstname, lastname, and email fields..
customer_ids stringSpecify the records you want to retrieve using the customer_ids. Seperate using ','
bash
curl --request GET \
  --url 'https://api.bunce.so/v1/customers?page=1&per_page=10' \
  --header 'Accept: application/json' \
  --header 'X-Authorization: sk_live_************************'
go
import (
	"fmt"
	"net/http"
	"io/ioutil"
)

url := "https://api.bunce.so/v1/customers?page=1&per_page=10"

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

	req.Header.Add("Accept", "application/json")
	req.Header.Add("X-Authorization", "sk_live_************************")

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

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

	fmt.Println(res)
	fmt.Println(string(body))
js
import  from 'node-fetch'

let  = 'https://api.bunce.so/v1/customers?page=1&per_page=10'

let  = {
  : 'GET',
  : {
    : 'application/json',
    'X-Authorization': 'sk_live_************************',
  },
}

(, )
  .then(() => .json())
  .then(() => .())
  .catch(() => .('error:' + ))
php
<?php

$client = new http\Client;
$request = new http\Client\Request;

$request->setRequestUrl('https://api.bunce.so/v1/customers');
$request->setRequestMethod('GET');
$request->setQuery(new http\QueryString([
  'page' => '1',
  'per_page' => '10'
]));

$request->setHeaders([
  'Accept' => 'application/json',
  'X-Authorization' => 'sk_live_************************'
]);

$client->enqueue($request)->send();
$response = $client->getResponse();

echo $response->getBody();
java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.bunce.so/v1/customers?page=1&per_page=10"))
    .header("Accept", "application/json")
    .header("X-Authorization", "sk_live_************************")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = HttpClient.newHttpClient().send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

Response

json
{
  "data": {
    "data": [
      {
        "customer_id": "0000",
        "first_name": "Darrell",
        "last_name": "Bayer",
        "email": "richie77@example.org",
        "phone_no": "+18304975723",
        "customer_created_at": "2023-12-07T09:15:34Z",
        "updated_at": "2023-12-06T13:09:11Z",
        "providers": "Paystack",
        "last_interaction": "2023-12-02T09:59:50Z"
      },
      {
        "customer_id": "1111",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe@example.org",
        "phone_no": "+18304975723",
        "customer_created_at": "2023-12-07T09:15:34Z",
        "updated_at": "2023-12-06T13:09:11Z",
        "providers": "Paystack,Flutterwave",
        "last_interaction": "2023-12-02T09:59:50Z"
      },
      {
        "customer_id": "2222",
        "first_name": "John",
        "last_name": "Doe",
        "email": "johndoe1@example.org",
        "phone_no": "+18304975723",
        "customer_created_at": "2023-12-07T09:15:34Z",
        "updated_at": "2023-12-06T13:09:11Z",
        "providers": "Paystack,Flutterwave,Stripe",
        "last_interaction": "2023-12-02T09:59:50Z"
      }
    ],
    "meta": {
      "per_page": 20,
      "total": 10000,
      "total_pages": 200
    }
  },
  "message": "Customers fetched successfully",
  "success": true
}