Skip to main content
GET
/
v1
/
dashboard
/
my-companies
curl https://api.vouchmark.com/v1/dashboard/my-companies \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": {
    "company": {
      "id": "cmp_aBcD...",
      "companyName": "TEKCIFY TECHNOLOGIES LTD",
      "rcNumber": "8511136",
      "ownerId": "usr_aBcD...",
      "active": true,
      "classification": {
        "id": 2,
        "label": "Private Company Limited by Shares"
      },
      "profile": {
        "natureOfBusiness": "Software",
        "businessCategory": "Technology",
        "businessDescription": "Software development",
        "businessCommencementDate": "2024-09-18",
        "registrationDate": "2024-09-18",
        "registrationApproved": true,
        "companyDetails": true,
        "logoUrl": "https://cdn.vouchmark.com/..."
      },
      "contact": {
        "email": "hello@tekcify.com",
        "address": "14 Marina Road",
        "city": "Lagos",
        "state": "Lagos",
        "lga": "Lagos Island"
      },
      "tax": {
        "firsTin": "2522576963525",
        "jtbtin": null,
        "firsttin_pending": false
      },
      "shares": {
        "shareCapital": 10000,
        "dividedInto": "10000",
        "shareHolderDetails": []
      },
      "registrarInfo": null,
      "socials": {
        "website": "https://tekcify.com",
        "facebook": null,
        "instagram": null,
        "linkedin": null,
        "twitter": null,
        "tiktok": null
      },
      "vouchmark_tools": {
        "vouch_mark": 90,
        "activeBank": true,
        "social_verified": true,
        "bill_verified": true,
        "address_verified": true,
        "cacert_verified": true,
        "cacreport_verified": true,
        "website_verified": true,
        "firstaxClearance_vr": true,
        "firsttin_pending": false,
        "jtbtin_vr": false,
        "memartVerified": true,
        "physical_address_verified": true,
        "shareHolderVerified": true
      },
      "documents": {
        "cacCertificateUrl": "https://cdn.vouchmark.com/..."
      },
      "stats": {
        "view_count": 0,
        "search_view_count": 0
      }
    }
  }
}
Returns every company claimed by the caller, sanitized for the dashboard. Pass id to fetch a single company instead of the list.

​
Query

​
id
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)

​
success
boolean
​
data.companies
array
Array of sanitized company records (see the single shape below).

​
Response (single)

​
success
boolean
​
data.company
object
One sanitized company record.
​
data.company.classification
object
id and label for the company’s CAC classification.
​
data.company.profile
object
natureOfBusiness, businessCategory, businessDescription, businessCommencementDate, registrationDate, registrationApproved, companyDetails, logoUrl.
​
data.company.contact
object
email, address, city, state, lga.
​
data.company.tax
object
firsTin, jtbtin, firsttin_pending.
​
data.company.shares
object
shareCapital, dividedInto, and shareHolderDetails (an array of shareholders).
​
data.company.socials
object
website, facebook, instagram, linkedin, twitter, tiktok.
​
data.company.vouchmark_tools
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.
​
data.company.documents
object
cacCertificateUrl.
​
data.company.stats
object
view_count, search_view_count.
curl https://api.vouchmark.com/v1/dashboard/my-companies \
  -H "Authorization: Bearer $TOKEN"

{
  "success": true,
  "data": {
    "company": {
      "id": "cmp_aBcD...",
      "companyName": "TEKCIFY TECHNOLOGIES LTD",
      "rcNumber": "8511136",
      "ownerId": "usr_aBcD...",
      "active": true,
      "classification": {
        "id": 2,
        "label": "Private Company Limited by Shares"
      },
      "profile": {
        "natureOfBusiness": "Software",
        "businessCategory": "Technology",
        "businessDescription": "Software development",
        "businessCommencementDate": "2024-09-18",
        "registrationDate": "2024-09-18",
        "registrationApproved": true,
        "companyDetails": true,
        "logoUrl": "https://cdn.vouchmark.com/..."
      },
      "contact": {
        "email": "hello@tekcify.com",
        "address": "14 Marina Road",
        "city": "Lagos",
        "state": "Lagos",
        "lga": "Lagos Island"
      },
      "tax": {
        "firsTin": "2522576963525",
        "jtbtin": null,
        "firsttin_pending": false
      },
      "shares": {
        "shareCapital": 10000,
        "dividedInto": "10000",
        "shareHolderDetails": []
      },
      "registrarInfo": null,
      "socials": {
        "website": "https://tekcify.com",
        "facebook": null,
        "instagram": null,
        "linkedin": null,
        "twitter": null,
        "tiktok": null
      },
      "vouchmark_tools": {
        "vouch_mark": 90,
        "activeBank": true,
        "social_verified": true,
        "bill_verified": true,
        "address_verified": true,
        "cacert_verified": true,
        "cacreport_verified": true,
        "website_verified": true,
        "firstaxClearance_vr": true,
        "firsttin_pending": false,
        "jtbtin_vr": false,
        "memartVerified": true,
        "physical_address_verified": true,
        "shareHolderVerified": true
      },
      "documents": {
        "cacCertificateUrl": "https://cdn.vouchmark.com/..."
      },
      "stats": {
        "view_count": 0,
        "search_view_count": 0
      }
    }
  }
}
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" }.