Companies
List my companies
Return the companies owned by the authenticated user.
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.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" }.