---
title: "OpenID Connect userinfo"
method: GET
path: "/v1/oauth/userinfo"
tags: ["OAuth"]
---

# OpenID Connect userinfo

`GET /v1/oauth/userinfo`

## Request

- Base URL: `https://api.assinafy.com.br`
- URL: `https://api.assinafy.com.br/v1/oauth/userinfo`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Claims about the user who authorized this token. Requires the openid scope; name requires profile and email requires email. Per OIDC Core §5.3.2, the response is a flat JSON object of claims — never this API's usual `{status, data, message}` envelope.

[Copy as Markdown](https://api.assinafy.com.br/v1/docs/markdown?method=get&path=%2Fv1%2Foauth%2Fuserinfo) [Open in ChatGPT](https://chatgpt.com/?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Foauth%252Fuserinfo%20and%20help%20me%20integrate%20this%20endpoint.) [Open in Claude](https://claude.ai/new?q=Read%20the%20API%20documentation%20at%20https%3A%2F%2Fapi.assinafy.com.br%2Fv1%2Fdocs%2Fmarkdown%3Fmethod%3Dget%26path%3D%252Fv1%252Foauth%252Fuserinfo%20and%20help%20me%20integrate%20this%20endpoint.)

## Response `200`

The user's claims

- object
  - `sub` string
  - `name` string, nullable
  - `email` string, email, nullable
  - `email_verified` boolean, nullable

## Other responses

- `401`: Missing or invalid credentials.
- `403`: Authenticated but not allowed to perform this action.
- `500`: Unexpected server error.

## Changes

- **2026-09-17** `6b55ce24462c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/assinafy/apis/assinafy-api-reference/changes/v1/oauth/userinfo/get.md)

---

[API](https://skmtc.dev/assinafy/apis/assinafy-api-reference.md) - [All operations](https://skmtc.dev/assinafy/apis/assinafy-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/assinafy/apis/assinafy-api-reference/revisions/3672991376b6?raw)