Get the current user

GET /me

Updated 16 Sep 20261 min read

GET/meTry it

Basehttps://api.mockflow.com/v1Scopesuser:read

Request

curl https://api.mockflow.com/v1/me \
  -H "Authorization: Bearer $MOCKFLOW_API_KEY"

const response = await fetch("https://api.mockflow.com/v1/me", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MOCKFLOW_API_KEY}`
  }
});

const data = await response.json();

import os, requests

response = requests.get(
    "https://api.mockflow.com/v1/me",
    headers={"Authorization": f"Bearer {os.environ['MOCKFLOW_API_KEY']}"},
)

response.raise_for_status()
data = response.json()

Response

{
  "id": "string",
  "email": "jane@acme.com",
  "name": "Q4 Launch Planning",
  "firstName": "Q4 Launch Planning",
  "lastName": "Q4 Launch Planning",
  "createdAt": "2026-10-01T09:30:00Z"
}

{
  "error": {
    "code": "unauthorized",
    "message": "Provide a Bearer token. Create one at mockflow.com/developers/console."
  },
  "requestId": "req_01j8"
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests.",
    "docsUrl": "https://mockflow.com/developers/concepts/errors#rate_limited"
  },
  "requestId": "req_45d49816999bac40"
}

The person behind the token, the workspace they belong to, and its plan.

Authorization

Authorizationstringheaderrequired

Bearer <key>. The key needs user:read scope. Create and manage keys in the developer console; what each scope unlocks is on the scopes page.

Response

200 · application/json

idstring

emailstring

namestring

firstNamestring

lastNamestring

createdAtstring | null

workspaceobject

Child attributes

idstring

namestring

planenum<string>

The three plans. An enterprise licence is a max plan. One of basic, plus or max.

dayPassboolean

dayPassEndsAtstring | null

teamPackboolean

businessboolean

The workspace holds a board business licence.

boardCountinteger

spaceCountinteger

tokenobject

Child attributes

kindenum<string>

One of personal, service or oauth.

namestring | null

scopesstring[]

Errors

401unauthorized

Missing or invalid token.

429rate_limited

Too many requests.

Was this page helpful?