---
title: "Quem é a pessoa que conectou (OIDC UserInfo)."
method: GET
path: "/api/mcp-oauth/userinfo"
tags: ["OAuth"]
---

# Quem é a pessoa que conectou (OIDC UserInfo).

`GET /api/mcp-oauth/userinfo`

## Request

- Base URL: `https://api.juspronto.com.br`
- URL: `https://api.juspronto.com.br/api/mcp-oauth/userinfo`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.juspronto.com.br/api/mcp-oauth/authorize`, token URL `https://api.juspronto.com.br/api/mcp-oauth/token`)

Devolve o identificador opaco e estável da pessoa (`sub`) e, só se a conexão pediu o escopo `email`, o e-mail e se ele foi confirmado (`email_verified`, falso enquanto não houver confirmação). Autentica com o token de acesso do conector no cabeçalho `Authorization: Bearer`, nunca na URL. Um token sem `openid`, como o das conexões antigas, também recebe 200, só com `sub`. A chave de API criada à mão não tem pessoa por trás e não serve aqui. O POST responde igual. Não dá acesso a dado nenhum do escritório.

## Response `200`

Os dados da pessoa que o escopo da conexão permite.

- DadosDaPessoaConectada: Claims do OIDC UserInfo. `email` e `email_verified` só saem se a conexão pediu o escopo `email`.
  - `sub` string, required: Identificador opaco e estável da pessoa. Não muda com reconexão, renovação ou troca de e-mail.
  - `email` string, email: E-mail da pessoa. Só com o escopo `email`.
  - `email_verified` boolean: Verdadeiro só quando o e-mail foi confirmado; sem confirmação, falso. Só com o escopo `email`.

## Other responses

- `401`: Sem o cabeçalho `Authorization: Bearer` (`invalid_request`), ou com um token que não é um token de acesso do conector, expirado ou revogado (`invalid_token`).
- `429`: Limite de requisições atingido. A espera em segundos vem em `Retry-After`; o teto e a janela vêm em `RateLimit-Policy`. Aguarde antes de repetir: não é falha do servidor.

---

[API](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau.md) · [All operations](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/llms.txt) · [OpenAPI document](https://skmtc.dev/juspronto/apis/juspronto-superficie-publica-para-agentes-conector-mcp-e-oau/revisions/b2c70e4e0734?raw)