# Who am I

Returns information about the authenticated caller — `company_id`,
`user_id`, and (when present in the token) `company_name` and `email`.

Endpoint: GET /v1/me
Security: OAuth2

## Security:

  - `OAuth2` (unknown)
    oauth2

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `company_id` (string, required)
    Your company's ID.

  - `company_name` (string)
    Your company's name. May be omitted when the issuing token does
not carry a `companyName` extension claim.

  - `user_id` (string, required)
    Your user ID (the JWT `sub` claim).

  - `email` (string)
    Your email address. May be omitted when the issuing token does not
carry an `email` extension claim.

## Response default:

  - `default` (unknown)
    An unexpected error occurred.

## Response default fields (application/json):

  - `code` (string, required)
    Machine-readable error code. Each code always comes with the same HTTP status:
`BAD_REQUEST` (400), `UNAUTHORIZED` (401), `FORBIDDEN` (403), `NOT_FOUND` (404),
`CONFLICT` (409), `PRECONDITION_FAILED` (412), `TOO_MANY_REQUESTS` (429),
`INTERNAL_SERVER_ERROR` (500), `NOT_IMPLEMENTED` (501), `SERVICE_UNAVAILABLE` (503)
and `GATEWAY_TIMEOUT` (504).
The list is extensible: handle an unknown code by its HTTP status.
    Example: BAD_REQUEST

  - `message` (string, required)
    Human-readable description of the error, and how to resolve it where possible.