Get User Information

Retrieve information about the currently authenticated user and their associated company. This endpoint is useful for verifying your authentication and understanding which account context you’re operating in.

Endpoint

GET /api/oauth/me

Use Cases

  • Verify that your authentication is working correctly
  • Determine which company context your requests will operate under
  • Display user information in your application
  • Validate that you’re using the correct account

Request

GET /api/oauth/me HTTP/1.1
Host: app.heyjodie.com
Authorization: Bearer YOUR_ACCESS_TOKEN

Headers:

  • Authorization: Required. Your OAuth 2.0 bearer token

Parameters: None

Response

Status Code: 200 OK

{
  "id": "usr_abc123",
  "name": "John Doe",
  "email": "[email protected]",
  "company_id": "com_xyz789"
}

Response Fields

FieldTypeDescription
idstringUnique identifier for the user (prefixed with usr_)
namestringFull name of the user
emailstringEmail address associated with the account
company_idstringUnique identifier for the user’s company (prefixed with com_)

Example Usage

curl -X GET "https://app.heyjodie.com/api/oauth/me" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Error Responses

401 Unauthorized

The access token is missing, invalid, or expired.

{
  "message": "Unauthenticated."
}

Solution: Check your token and ensure it’s properly formatted in the Authorization header.

403 Forbidden

You’re using an admin account, which cannot access OAuth endpoints.

{
  "message": "OAuth2 access is restricted to user accounts only."
}

Solution: Use a USER role account instead of an admin account.

Next Steps

Once you’ve verified your authentication, list calls to retrieve your call data.