Brands
List brands
get/v1/brands
bash
curl https://sandbox.api.biftpay.com/v1/brands \
-H "Authorization: Bearer bp_test_..."Responses
- 200OKobject
Fields
object"list"requireddataarray of BrandrequiredFields of data
idstring (uuid)requiredobject"brand"requirednamestringrequireddisplay_namestring | nullsupport_emailstring | nullstatusactive | archivedrequiredis_defaultbooleanrequiredThe business itself, created at signup with the business name. Can't be archived; anything without a brand belongs to it.
settlement_bank_accountstring (uuid) | nullrequiredWhere this brand's naira settles; null uses the business's settlement account.
categoryretail_ecommerce | fashion_beauty | food_restaurants | supermarkets | education | healthcare_pharmacy | travel_transport | hotels_hospitality | logistics | software_saas | digital_services | media_entertainment | events_tickets | real_estate | construction | agriculture | manufacturing | professional_services | legal | accounting_audit_tax | jewellery_precious_metals | car_dealers | religious_organisation | ngo_charity | other | betting_gaming | crypto_digital_assets | forex_investment | lending_credit | money_transfer or nulldescriptionstring | nullwebsitestring | nullsupport_phonestring | nullbusiness_name_numberstring | nullreviewBrandReviewrequiredFields of review
statuspending | approved | rejected | suspendedrequiredOnly
approvedbrands take live payments. A suspended brand's live balance isn't paid out or settled.reasonstring | nullrequiredCompliance's reason for a rejection or suspension.
risklow | review | restricted | nullrequirednull for the business's own brand.
licence_neededstring | nullrequiredThe licence a restricted category needs.
requirementsarray of licencerequiredStill needed before compliance can approve.
submitted_atstring (date-time) | nullrequiredreviewed_atstring (date-time) | nullrequiredcreated_atstring (date-time)requiredhas_moreboolean