Skip to main content
GET
Returns every company claimed by the caller, sanitized for the dashboard. Pass id to fetch a single company instead of the list.

Query

string
Company ID. When set, the response contains a single company object instead of companies. The company must be owned by the caller.

Response (collection)

boolean
array
Array of sanitized company records (see the single shape below).

Response (single)

boolean
object
One sanitized company record.
object
id and label for the company’s CAC classification.
object
natureOfBusiness, businessCategory, businessDescription, businessCommencementDate, registrationDate, registrationApproved, companyDetails, logoUrl.
object
email, address, city, state, lga.
object
firsTin, jtbtin, firsttin_pending.
object
shareCapital, dividedInto, and shareHolderDetails (an array of shareholders).
object
website, facebook, instagram, linkedin, twitter, tiktok.
object
Verification flags and the live score: vouch_mark, activeBank, social_verified, bill_verified, address_verified, cacert_verified, cacreport_verified, website_verified, firstaxClearance_vr, firsttin_pending, jtbtin_vr, memartVerified, physical_address_verified, shareHolderVerified.
object
cacCertificateUrl.
object
view_count, search_view_count.
When id is supplied but no matching company is owned by the caller, the endpoint returns 404 with { "message": "Company not found or you don't have access to it" }.