---
title: "Obtém a ficha do membro pelo codpesso para a aplicação OE Despesas."
method: POST
path: "/api/OEGest/membro"
tags: ["OEGest"]
---

# Obtém a ficha do membro pelo codpesso para a aplicação OE Despesas.

`POST /api/OEGest/membro`

## Request

- Base URL: `https://api.ordemenfermeiros.pt` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ordemenfermeiros.pt/api/OEGest/membro`
- Auth: none declared

Autentica a conta mobapi com username e password enviados no corpo do pedido.
A password é validada no SIGENF, pelo mesmo mecanismo usado em SendSMS. Não requer JWT.
O codpesso é o identificador da pessoa no SIGENF, em formato UUID/GUID.
Os campos numero_cc e validade_cc correspondem ao documento de identificação
registado, independentemente do tipo (CC, BI, passaporte ou outro).
Os seis campos são sempre devolvidos; dados em falta são representados por null.
            
Exemplo de pedido:
            
    POST /api/OEGest/membro
    Content-Type: application/json
            
    {
      "username": "mobapi",
      "password": "palavra-passe-da-conta",
      "codpesso": "11111111-2222-3333-4444-555555555555"
    }
            
Exemplo de resposta:
            
    {
      "nome": "Maria Silva",
      "email": "maria.silva@example.com",
      "telemovel": "912345678",
      "nif": "123456789",
      "numero_cc": "01234567",
      "validade_cc": "2030-12-31"
    }

## Request body

- OEDespesasMemberRequest: Credenciais e identificador da pessoa para consultar a ficha do membro.
  - `username` string, required: Conta técnica autorizada a consultar membros.
  - `password` string, password, required: Password da conta técnica, validada no SIGENF.
  - `codpesso` string, uuid, required: GUID da pessoa guardado na OE Despesas.

## Response `200`

OK

- OEDespesasMemberResponse: Dados da ficha do membro para a aplicação OE Despesas.
  - `nome` string, nullable: Nome completo do membro.
  - `email` string, nullable: Email pessoal do membro.
  - `telemovel` string, nullable: Telemóvel pessoal do membro.
  - `nif` string, nullable: Número de identificação fiscal, preservado como texto.
  - `numero_cc` string, nullable: Número do documento de identificação registado (CC, BI, passaporte ou outro). Corresponde a NRDOCID no SIGENF, independentemente do tipo de documento.
  - `validade_cc` string, date, nullable: Validade do documento registado, no formato YYYY-MM-DD.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-09-23** `d9d37bbd49fd`: 1 info
  - added the non-success response with the status `429`
- **2026-09-18** `b88b29292349`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ordemenfermeiros/apis/sigenf-api/changes/api/OEGest/membro/post.md)

---

[API](https://skmtc.dev/ordemenfermeiros/apis/sigenf-api.md) - [All operations](https://skmtc.dev/ordemenfermeiros/apis/sigenf-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ordemenfermeiros/apis/sigenf-api/revisions/d9d37bbd49fd?raw)