Validate customer details

curl --request GET \
  --url https://api.flutterwave.com/v3/bill-items/CB141/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'

import requests

url = "https://api.flutterwave.com/v3/bill-items/CB141/validate"

headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'}
};

fetch('https://api.flutterwave.com/v3/bill-items/CB141/validate', 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.flutterwave.com/v3/bill-items/CB141/validate",
  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>",
    "Content-Type: <content-type>"
  ],
]);

$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.flutterwave.com/v3/bill-items/CB141/validate"

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

	req.Header.Add("Content-Type", "<content-type>")
	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.flutterwave.com/v3/bill-items/CB141/validate")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bill-items/CB141/validate")

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

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

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

{
  "status": "success",
  "message": "Item validated successfully",
  "data": {
    "response_code": "00",
    "address": null,
    "response_message": "Successful",
    "name": "Test DSTV Account",
    "biller_code": "BIL119",
    "customer": "0025401100",
    "product_code": "CB141",
    "email": null,
    "fee": 0,
    "maximum": 0,
    "minimum": 0
  }
}

{
  "status": "error",
  "message": "Invalid customer id",
  "data": null
}

GET

bill-items

CB141

validate

Validate customer details

curl --request GET \
  --url https://api.flutterwave.com/v3/bill-items/CB141/validate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>'

import requests

url = "https://api.flutterwave.com/v3/bill-items/CB141/validate"

headers = {
    "Content-Type": "<content-type>",
    "Authorization": "Bearer <token>"
}

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

print(response.text)

const options = {
  method: 'GET',
  headers: {'Content-Type': '<content-type>', Authorization: 'Bearer <token>'}
};

fetch('https://api.flutterwave.com/v3/bill-items/CB141/validate', 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.flutterwave.com/v3/bill-items/CB141/validate",
  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>",
    "Content-Type: <content-type>"
  ],
]);

$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.flutterwave.com/v3/bill-items/CB141/validate"

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

	req.Header.Add("Content-Type", "<content-type>")
	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.flutterwave.com/v3/bill-items/CB141/validate")
  .header("Content-Type", "<content-type>")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.flutterwave.com/v3/bill-items/CB141/validate")

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

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

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

{
  "status": "success",
  "message": "Item validated successfully",
  "data": {
    "response_code": "00",
    "address": null,
    "response_message": "Successful",
    "name": "Test DSTV Account",
    "biller_code": "BIL119",
    "customer": "0025401100",
    "product_code": "CB141",
    "email": null,
    "fee": 0,
    "maximum": 0,
    "minimum": 0
  }
}

{
  "status": "error",
  "message": "Invalid customer id",
  "data": null
}

Authorizations

Authorization

string

header

required

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

Headers

Content-Type

enum<string>

required

Available options:

application/json

Example:

"application/json"

Query Parameters

code

string

required

Example:

"BIL119"

customer

integer<int32>

required

Example:

5636672

Response

status

string

required

message

string

required

data

Data73 · object

required

Show child attributes

Example:

{
  "response_code": "00",
  "address": null,
  "response_message": "Successful",
  "name": "Test DSTV Account",
  "biller_code": "BIL119",
  "customer": "0025401100",
  "product_code": "CB141",
  "email": null,
  "fee": 0,
  "maximum": 0,
  "minimum": 0
}

API Documentation

Charges

Tokenized Charges

Preauthorization

Transactions

Transfers

Beneficiaries

Virtual Cards

Virtual Account Numbers

Collection Subaccounts

Payout Subaccounts

Subscriptions

Payment Plans

Bill Payments

Banks

Misc

Settlements

Otps

Chargebacks

Validate customer details

Authorizations

Headers

Query Parameters

Response