> ## Documentation Index > Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Obter membro > Retorna os detalhes de um membro específico. ## OpenAPI ````yaml openapi.yaml GET /v1/member/{member-id} openapi: 3.1.0 info: title: Pipo Public API version: 0.2.0 description: > API pública da Pipo Saúde para integração de movimentações de benefícios (inclusões, exclusões e consultas) por parceiros e sistemas de folha de pagamento. contact: name: Pipo Engineering email: felipe.rodopoulos@piposaude.com.br servers: - url: https://api.pipo.health description: Homologação (staging) - url: https://api.piposaude.com.br description: Produção security: - bearerAuth: [] tags: - name: Autenticação description: Obtenção do token de acesso. - name: Empresas description: Consulta de empresas e seus produtos. - name: Benefícios description: Consulta de produtos/benefícios disponíveis. - name: Movimentações description: Inclusões, exclusões e histórico de movimentações. - name: Membros description: Consulta de membros e seus benefícios. - name: Solicitações description: Consulta do status de requisições assíncronas. - name: Health Check description: Verificação de disponibilidade. paths: /v1/member/{member-id}: get: tags: - Membros summary: Obter membro description: Retorna os detalhes de um membro específico. parameters: - name: member-id in: path required: true schema: type: string format: uuid description: ID do membro. - $ref: '#/components/parameters/IncludeInactives' responses: '200': description: Detalhe do membro. content: application/json: schema: type: object properties: result: $ref: '#/components/schemas/Member' example: result: id: 111e2222-e89b-12d3-a456-426614174003 profile: name: João Silva preferred-name: João mothers-name: Maria Silva date-of-birth: '1985-05-15' gender: male marital-status: married tax-id: '12345678900' national-id-type: RG national-id-number: 12.345.678-9 national-id-issuer: SSP contact: email: joao.silva@email.com phone: '11987654321' address: postal-code: 01234-567 street: Rua das Flores number: '123' neighborhood: Centro city: São Paulo state: SP benefits: - benefit-id: 333e4444-e89b-12d3-a456-426614174004 status: active company-tax-id: '12345678000190' product-id: 456e7890-e89b-12d3-a456-426614174001 product-name: Plano Saúde Premium product-type: health-insurance carrier-name: HealthCorp type: primary id-card-number: '123456789' start-date: '2024-01-01' dependents: - member-id: 555e6666-e89b-12d3-a456-426614174011 status: active profile: name: Maria Silva mothers-name: Ana Silva date-of-birth: '1990-03-20' gender: female marital-status: married relationship-type: spouse relationship-start-date: '2015-06-10' work-contracts: - company-tax-id: '12345678000190' admission-date: '2023-12-01' work-contract-type: brazil-labor-law job-title: Desenvolvedor Senior employee-id: EMP001 cost-center: TI-001 income-amount: 800000 '204': description: Membro existe, mas não possui benefícios. '403': description: Não autorizado a acessar este membro. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: Not entitled to access this member components: parameters: IncludeInactives: name: include-inactives in: query required: false schema: type: boolean default: false description: Quando `true`, inclui membros/benefícios inativos. schemas: Member: type: object required: - id - profile - benefits properties: id: type: string format: uuid profile: $ref: '#/components/schemas/Profile' contact: $ref: '#/components/schemas/Contact' benefits: type: array items: $ref: '#/components/schemas/Benefit' work-contracts: type: array items: $ref: '#/components/schemas/WorkContractResponse' Error: type: object required: - error properties: error: type: string description: Mensagem descritiva do erro. Profile: type: object required: - name - mothers-name - date-of-birth - gender - marital-status properties: name: type: string description: Nome do membro. preferred-name: type: string description: Nome social/preferido. mothers-name: type: string description: Nome da mãe do membro. date-of-birth: type: string format: date description: Data de nascimento. gender: $ref: '#/components/schemas/Gender' marital-status: $ref: '#/components/schemas/MaritalStatus' tax-id: $ref: '#/components/schemas/Cpf' national-id-type: $ref: '#/components/schemas/NationalIdType' national-id-number: type: string description: 'Número do documento de identidade (ex.: RG).' national-id-issuer: type: string description: 'Órgão emissor do documento (ex.: SSP).' Contact: type: object required: - email properties: email: type: string format: email phone: type: string description: 'Telefone com DDD (ex.: 11987654321).' address: $ref: '#/components/schemas/Address' Benefit: type: object required: - benefit-id - status - company-tax-id - product-id - product-name - product-type - carrier-name - type properties: benefit-id: type: string format: uuid status: type: string description: 'Status do benefício (ex.: active).' company-tax-id: $ref: '#/components/schemas/Cnpj' product-id: type: string format: uuid product-name: type: string product-type: $ref: '#/components/schemas/ProductType' carrier-name: type: string type: $ref: '#/components/schemas/MemberType' id-card-number: type: string start-date: type: string format: date dependents: type: array items: $ref: '#/components/schemas/DependentBenefit' WorkContractResponse: type: object required: - company-tax-id - admission-date - work-contract-type properties: company-tax-id: $ref: '#/components/schemas/Cnpj' admission-date: type: string format: date work-contract-type: $ref: '#/components/schemas/WorkContractType' job-title: type: string employee-id: type: string cost-center: type: string income-amount: type: integer description: Renda em centavos (R$ 1.234 56 = 123456).: null Gender: type: string description: Sexo biológico do membro. enum: - male - female MaritalStatus: type: string description: >- Estado civil. single=Solteiro, married=Casado, divorced=Divorciado, widowed=Viúvo, others=Outros. enum: - single - married - divorced - widowed - others Cpf: type: string description: CPF (Cadastro de Pessoas Físicas). Aceita apenas dígitos ou formatado. examples: - '12345678900' - 123.456.789-00 NationalIdType: type: string description: Tipo de documento de identidade nacional. enum: - RG - RNM - CNH - passport Address: type: object properties: postal-code: type: string description: CEP. street: type: string number: type: string neighborhood: type: string city: type: string state: type: string description: 'UF (2 letras, ex.: SP).' Cnpj: type: string description: >- CNPJ (Cadastro Nacional da Pessoa Jurídica). Aceita apenas dígitos ou formatado. examples: - '12345678000190' - 12.345.678/0001-90 ProductType: type: string description: Tipo de produto/benefício. enum: - health-insurance - dental-insurance - life-insurance - mental-health - gym - pet-insurance - private-pension - air-medical-transport - health-navigation MemberType: type: string description: Tipo de membro. primary=Titular, dependent=Dependente. enum: - primary - dependent DependentBenefit: type: object required: - member-id - status - profile - relationship-type properties: member-id: type: string format: uuid status: type: string description: 'Status do benefício (ex.: active).' profile: $ref: '#/components/schemas/Profile' relationship-type: $ref: '#/components/schemas/RelationshipType' relationship-start-date: type: string format: date WorkContractType: type: string description: Tipo de contrato de trabalho. enum: - brazil-labor-law - services-contract - partner - intern - on-leave - other RelationshipType: type: string description: Tipo de relação do dependente com o titular. enum: - adopted-child - child - companion - grandchild - grandparent - great-grandchild - niece-or-nephew - parent-in-law - parent - sibling - spouse - stepchild - uncle-or-aunt - unknown - ward securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: Token Bearer obtido em `POST /v1/authenticate`. ````