---
title: "Get credential info"
method: GET
path: "/api/app/me"
tags: ["App"]
---

# Get credential info

`GET /api/app/me`

## Request

- Base URL: `https://core-api.getaptly.com`
- URL: `https://core-api.getaptly.com/api/app/me`
- Auth: one of:
  - API key in header `x-token`
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/getaptly/apis/aptly-api/docs/api/app/me/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns identity information for the credential used in the request. The response shape
depends on the auth method:

- **Delegate token** (`Authorization: DelegateToken <token>`): returns user identity and,
  if the token has an `appClientId`, embedded-app context.
- **API key** (`x-token` header or query param): returns company identity.
- **Partner token** (`Authorization: Bearer <token>`): returns the partner's permission list.

## Response `200`

Credential identity.

- union
  - object
    - `type` 'user'
    - `userId` string
    - `email` string, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `companyId` string
    - `companyName` string, nullable
  - object
    - `type` 'app'
    - `userId` string
    - `email` string, nullable
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `companyId` string
    - `companyName` string, nullable
    - `appClientId` string
    - `appTitle` string, nullable
  - object
    - `type` 'apiKey'
    - `companyId` string
    - `companyName` string, nullable
  - object
    - `type` 'partner'
    - `permissions` string[]

## Other responses

- `401`: Invalid or missing credential.

---

[API](https://skmtc.dev/getaptly/apis/aptly-api.md) - [All operations](https://skmtc.dev/getaptly/apis/aptly-api/llms.txt) - [OpenAPI document](https://skmtc.dev/getaptly/apis/aptly-api/revisions/75c367e0b8e5?raw)