> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vouchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List my companies

> Return the companies owned by the authenticated user.

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

## Query

<ParamField query="id" type="string">
  Company ID. When set, the response contains a single `company` object instead of `companies`. The company must be owned by the caller.
</ParamField>

## Response (collection)

<ResponseField name="success" type="boolean" />

<ResponseField name="data.companies" type="array">
  Array of sanitized company records (see the single shape below).
</ResponseField>

## Response (single)

<ResponseField name="success" type="boolean" />

<ResponseField name="data.company" type="object">
  One sanitized company record.
</ResponseField>

<ResponseField name="data.company.classification" type="object">
  `id` and `label` for the company's CAC classification.
</ResponseField>

<ResponseField name="data.company.profile" type="object">
  `natureOfBusiness`, `businessCategory`, `businessDescription`, `businessCommencementDate`, `registrationDate`, `registrationApproved`, `companyDetails`, `logoUrl`.
</ResponseField>

<ResponseField name="data.company.contact" type="object">
  `email`, `address`, `city`, `state`, `lga`.
</ResponseField>

<ResponseField name="data.company.tax" type="object">
  `firsTin`, `jtbtin`, `firsttin_pending`.
</ResponseField>

<ResponseField name="data.company.shares" type="object">
  `shareCapital`, `dividedInto`, and `shareHolderDetails` (an array of shareholders).
</ResponseField>

<ResponseField name="data.company.socials" type="object">
  `website`, `facebook`, `instagram`, `linkedin`, `twitter`, `tiktok`.
</ResponseField>

<ResponseField name="data.company.vouchmark_tools" type="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`.
</ResponseField>

<ResponseField name="data.company.documents" type="object">
  `cacCertificateUrl`.
</ResponseField>

<ResponseField name="data.company.stats" type="object">
  `view_count`, `search_view_count`.
</ResponseField>

<RequestExample>
  ```bash All my companies theme={null}
  curl https://api.vouchmark.com/v1/dashboard/my-companies \
    -H "Authorization: Bearer $TOKEN"
  ```

  ```bash One company by ID theme={null}
  curl "https://api.vouchmark.com/v1/dashboard/my-companies?id=cmp_aBcD..." \
    -H "Authorization: Bearer $TOKEN"
  ```
</RequestExample>

<ResponseExample>
  ```json Single theme={null}
  {
    "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
        }
      }
    }
  }
  ```

  ```json Collection theme={null}
  {
    "success": true,
    "data": {
      "companies": []
    }
  }
  ```
</ResponseExample>

<Note>
  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" }`.
</Note>