> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pied.com.br/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Retorna os dados completos do colaborador

> Retorna os dados completos do colaborador, incluindo a lista de todos os orçamentos, pedidos e empresas de energia no qual este colaborador é responsável.

<Note>
  **API v1** - Este endpoint está disponível apenas na v1
</Note>


## OpenAPI

````yaml /openapi/openapi-v1.json GET /staff/{staffEmail}
openapi: 3.0.0
info:
  title: PIED API v1
  version: '1.0'
  description: >-
    API para gerenciamento de orçamentos, pedidos, equipamentos, empresas e
    colaboradores do sistema PIED.
servers:
  - url: https://backend-pied-prod.piedadmin.com.br/api/v1
    description: Servidor de produção v1
security:
  - bearerAuth: []
tags:
  - name: Request
    description: Tudo sobre orçamentos ou pedidos
  - name: Equipment
    description: Tudo sobre equipamentos
  - name: Company
    description: Tudo sobre empresas de energia
  - name: Staff
    description: Tudo sobre colaboradores
paths:
  /staff/{staffEmail}:
    get:
      tags:
        - Staff
      summary: Retorna os dados completos do colaborador
      description: >-
        Retorna os dados completos do colaborador, incluindo a lista de todos os
        orçamentos, pedidos e empresas de energia no qual este colaborador é
        responsável.
      parameters:
        - name: staffEmail
          in: path
          description: Determina o e-mail do colaborador a ser retornado.
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/staff'
        '204':
          description: Nenhum registro encontrado
        '401':
          description: Esta funcionalidade está indisponível no momento
        '404':
          description: Não encontrado
        '429':
          description: >-
            hardLimit: O limite de requisições por hora foi ultrapassado. Tente
            novamente mais tarde / timeLimit: O limite de 1 minuto de
            processamento de requisição por hora foi atingido. Tente novamente
            mais tarde
        '500':
          description: Erro na API
      security:
        - bearerAuth: []
components:
  schemas:
    staff:
      type: object
      properties:
        name:
          type: string
          example: Nome
        surname:
          type: string
          example: Sobrenome
        email:
          type: string
          example: email@email.com
        cellphone:
          type: string
          example: (00) 00000-0000
        role:
          type: string
          example: Vendedor
        address:
          $ref: '#/components/schemas/address'
        responsibleByCompanies:
          type: array
          items:
            $ref: '#/components/schemas/responsibleByCompanies'
        budgets:
          type: array
          items:
            type: string
            example: '200000000'
        orders:
          type: array
          items:
            type: string
            example: '200000000'
    address:
      type: object
      properties:
        CEP:
          type: string
          example: 00000-000
        state:
          type: string
          example: SC
        city:
          type: string
          example: Nome da Cidade
        neighborhood:
          type: string
          example: Nome do Bairro
        patio:
          type: string
          example: Nome da Rua
        number:
          type: string
          example: '1000'
        complement:
          type: string
          example: Bloco X, Casa Y
    responsibleByCompanies:
      type: object
      properties:
        cnpj:
          type: string
          example: 00.000.000/0000-00
        cpf:
          type: string
          example: 000.000.000-00
        fantasyName:
          type: string
          example: Nome fantasia
        companyName:
          type: string
          example: Razão social
        mainContact:
          $ref: '#/components/schemas/mainContactCompany'
        address:
          $ref: '#/components/schemas/address'
    mainContactCompany:
      type: object
      properties:
        name:
          type: string
          example: Nome
        surname:
          type: string
          example: Sobrenome
        email:
          type: string
          example: email@email.com
        cellphone:
          type: string
          example: (00) 00000-0000
        address:
          $ref: '#/components/schemas/address'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````