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

# get_identity

Return your own identity, company and access scope.

Use this first to learn *who you are acting as*, *which company you are in*, and
*what you are allowed to query*. The caller is returned as the same compact
summary `list_users` gives (name, email, role, currencies, status); the
company summary covers name, package, available currencies, fiscal calendar,
live/demo flags, and the connected integrations as id + name + type.

`access` lists, **per resource you can actually reach** (statement, request,
quota, data\_table), how broadly you see it (`scope` plus a plain-language
`description`) and the saved `views` you may pass to the matching list tool.
A resource you have no access to is **omitted** — if a resource is absent, do
not try to query it. Quota and data-table views carry `target_id` (the quota /
table they filter). Reports carry no access entry at all — call `list_reports`
to discover the ones shared with you.

Takes no arguments: the identity is read from the authenticated session, not
passed in. For the *full* profile (managers, groups, plan attributions, custom
attributes), call `get_user` with your own name or id.

## Response

<Accordion title="Body" defaultOpen>
  <ResponseField name="user" type="object">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="resource_url" type="string">
        Deep link to open this user in the Qobra web app.
      </ResponseField>

      <ResponseField name="name" type="string" />

      <ResponseField name="email" type="string" />

      <ResponseField name="status" type="string">
        User lifecycle state: pending (invited, not logged in yet), active,
        inactive (deactivated), archived (has left the company; hidden by
        default in list\_users). One of: `inactive`, `pending`, `active`,
        `archived`.
      </ResponseField>

      <ResponseField name="role" type="string">
        Name of the user's permission role (not their status).
      </ResponseField>

      <ResponseField name="payment_currency" type="string">
        Currency the user is actually paid in. One of: `AED`, `AFN`, `ALL`,
        `AMD`, `ANG`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BBD`, `BDT`,
        `BGN`, `BHD`, `BIF`, `BMD`, `BND`, `BOB`, `BOV`, `BRL`, `BSD`, `BTN`,
        `BWP`, `BYR`, `BZD`, `CAD`, `CDF`, `CHF`, `CLF`, `CLP`, `CNY`, `COP`,
        `COU`, `CRC`, `CUC`, `CUP`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`, `DZD`,
        `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`, `GIP`,
        `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HRK`, `HTG`, `HUF`, `IDR`,
        `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`, `KGS`,
        `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`, `LKR`,
        `LRD`, `LSL`, `LTL`, `LVL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`, `MMK`,
        `MNT`, `MOP`, `MRO`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`, `NAD`,
        `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`, `PHP`,
        `PKR`, `PLN`, `PYG`, `QAR`, `RMB`, `RON`, `RSD`, `RUB`, `RWF`, `SAR`,
        `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLL`, `SOS`, `SRD`, `STD`,
        `SVC`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`, `TTD`,
        `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYI`, `UYU`, `UZS`, `VEF`, `VND`,
        `VUV`, `WON`, `WST`, `XAF`, `XAG`, `XAU`, `XCD`, `XOF`, `XPD`, `XPF`,
        `XPT`, `XSU`, `YER`, `ZAR`, `ZMK`, `ZWL`.
      </ResponseField>

      <ResponseField name="calculation_currency" type="string">
        Currency the user's commissions are computed in. One of: `AED`, `AFN`,
        `ALL`, `AMD`, `ANG`, `AOA`, `ARS`, `AUD`, `AWG`, `AZN`, `BAM`, `BBD`,
        `BDT`, `BGN`, `BHD`, `BIF`, `BMD`, `BND`, `BOB`, `BOV`, `BRL`, `BSD`,
        `BTN`, `BWP`, `BYR`, `BZD`, `CAD`, `CDF`, `CHF`, `CLF`, `CLP`, `CNY`,
        `COP`, `COU`, `CRC`, `CUC`, `CUP`, `CVE`, `CZK`, `DJF`, `DKK`, `DOP`,
        `DZD`, `EGP`, `ERN`, `ETB`, `EUR`, `FJD`, `FKP`, `GBP`, `GEL`, `GHS`,
        `GIP`, `GMD`, `GNF`, `GTQ`, `GYD`, `HKD`, `HNL`, `HRK`, `HTG`, `HUF`,
        `IDR`, `ILS`, `INR`, `IQD`, `IRR`, `ISK`, `JMD`, `JOD`, `JPY`, `KES`,
        `KGS`, `KHR`, `KMF`, `KPW`, `KRW`, `KWD`, `KYD`, `KZT`, `LAK`, `LBP`,
        `LKR`, `LRD`, `LSL`, `LTL`, `LVL`, `LYD`, `MAD`, `MDL`, `MGA`, `MKD`,
        `MMK`, `MNT`, `MOP`, `MRO`, `MUR`, `MVR`, `MWK`, `MXN`, `MYR`, `MZN`,
        `NAD`, `NGN`, `NIO`, `NOK`, `NPR`, `NZD`, `OMR`, `PAB`, `PEN`, `PGK`,
        `PHP`, `PKR`, `PLN`, `PYG`, `QAR`, `RMB`, `RON`, `RSD`, `RUB`, `RWF`,
        `SAR`, `SBD`, `SCR`, `SDG`, `SEK`, `SGD`, `SHP`, `SLL`, `SOS`, `SRD`,
        `STD`, `SVC`, `SYP`, `SZL`, `THB`, `TJS`, `TMT`, `TND`, `TOP`, `TRY`,
        `TTD`, `TWD`, `TZS`, `UAH`, `UGX`, `USD`, `UYI`, `UYU`, `UZS`, `VEF`,
        `VND`, `VUV`, `WON`, `WST`, `XAF`, `XAG`, `XAU`, `XCD`, `XOF`, `XPD`,
        `XPF`, `XPT`, `XSU`, `YER`, `ZAR`, `ZMK`, `ZWL`.
      </ResponseField>

      <ResponseField name="licensed" type="boolean">
        Whether the user holds a paid Qobra license (a seat). Only licensed
        users have their compensations calculated and a statement to view — an
        unlicensed user's statement is never computed, which is the usual reason
        someone 'can't see X's statement'. A newly-arrived user typically needs
        a license added; a departed user who no longer appears in the data is a
        candidate for archiving to free their seat.
      </ResponseField>

      <ResponseField name="license_missing" type="boolean">
        True when the user is NOT licensed yet has compensations that would
        otherwise be calculated — the statement can't be computed for lack of a
        seat. This is what raises the red warning banner at the top of a
        statement; resolve it by assigning the user a license.
      </ResponseField>
    </Expandable>
  </ResponseField>

  <ResponseField name="company" type="object">
    <Expandable title="object properties">
      <ResponseField name="id" type="string" />

      <ResponseField name="name" type="string" />

      <ResponseField name="package" type="string">
        The company's Qobra subscription tier: core, advanced, scale, or others.
        Some features depend on it. One of: `core`, `advanced`, `scale`,
        `others`.
      </ResponseField>

      <ResponseField name="available_currencies" type="string[]" />

      <ResponseField name="integrations" type="object[]">
        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="name" type="string" />

          <ResponseField name="type" type="string">
            One of: `kombo`, `salesforce`, `pipedrive`, `microsoft_dynamics`,
            `hubspot`, `odoo`, `zoho`, `attio`, `postgresql`, `gcp-postgresql`,
            `snowflake`, `snowflake-keys`, `redshift`, `microsoft-azure-sql`,
            `microsoft-azure-synapse`, `bigquery`, `s3`, `sftp`, `netsuite`,
            `public_api`.
          </ResponseField>
        </Expandable>
      </ResponseField>

      <ResponseField name="created_at" type="string" />
    </Expandable>
  </ResponseField>

  <ResponseField name="access" type="object[]">
    <Expandable title="object properties">
      <ResponseField name="resource" type="string">
        One of: `statement`, `request`, `report`, `quota`, `data_table`.
      </ResponseField>

      <ResponseField name="scope" type="string">
        One of: `all`, `users_below`, `me`, `shared`.
      </ResponseField>

      <ResponseField name="description" type="string" />

      <ResponseField name="views" type="object[]">
        <Expandable title="object properties">
          <ResponseField name="id" type="string" />

          <ResponseField name="name" type="string" />

          <ResponseField name="target_id" type="string" />
        </Expandable>
      </ResponseField>
    </Expandable>
  </ResponseField>
</Accordion>
