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

# Listar Notas de Serviço (NFS-e)



## OpenAPI

````yaml /openapi-nfse.json get /notas
openapi: 3.0.1
info:
  title: Invo API Docs — NFS-e
  version: v1
servers:
  - url: https://invo.work/api/nfse/v1
security: []
tags:
  - name: Notas de Serviço
paths:
  /notas:
    get:
      tags:
        - Notas de Serviço
      summary: Listar Notas de Serviço (NFS-e)
      parameters:
        - name: X-Empresa-CNPJ
          in: header
          required: false
          schema:
            description: >-
              CNPJ da empresa emitente. Ausente, usa a primeira empresa da
              conta.
            type: string
        - name: codigo_externo
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                    codigo_externo:
                      type: string
                    descricao:
                      type: string
                    observacoes:
                      type: string
                    valor_servicos:
                      description: >-
                        * Número decimal codificado como texto. Por exemplo:
                        '123.45'
                      type: string
                      pattern: ^\d*\.?\d*$
                      format: decimal number
                    iss:
                      type: object
                      properties:
                        valor_liquido:
                          description: >-
                            * Número decimal codificado como texto. Por exemplo:
                            '123.45'
                          type: string
                          pattern: ^\d*\.?\d*$
                          format: decimal number
                        base_calculo:
                          description: >-
                            * Número decimal codificado como texto. Por exemplo:
                            '123.45'
                          type: string
                          pattern: ^\d*\.?\d*$
                          format: decimal number
                        aliquota_iss:
                          description: >-
                            * Número decimal codificado como texto. Por exemplo:
                            '123.45'
                          type: string
                          pattern: ^\d*\.?\d*$
                          format: decimal number
                        valor_iss:
                          description: >-
                            * Número decimal codificado como texto. Por exemplo:
                            '123.45'
                          type: string
                          pattern: ^\d*\.?\d*$
                          format: decimal number
                      required:
                        - valor_liquido
                        - base_calculo
                        - valor_iss
                      additionalProperties: false
                    rps:
                      type: object
                      properties:
                        situacao:
                          type: string
                        numero:
                          type: integer
                        serie:
                          type: string
                        tipo:
                          type: string
                        data_emissao:
                          type: string
                      additionalProperties: false
                    nfse:
                      type: object
                      properties:
                        situacao:
                          type: string
                        numero:
                          type: string
                        codigo_verificacao:
                          type: string
                        data_emissao:
                          type: string
                      required:
                        - situacao
                      additionalProperties: false
                    tomador:
                      type: object
                      properties:
                        razao_social:
                          type: string
                        cpf_cnpj:
                          type: string
                        email:
                          type: string
                        telefone:
                          type: string
                        endereco:
                          type: object
                          properties:
                            cep:
                              type: string
                            logradouro:
                              type: string
                            numero:
                              type: string
                            complemento:
                              type: string
                            bairro:
                              type: string
                            municipio:
                              type: string
                            uf:
                              type: string
                          required:
                            - cep
                            - logradouro
                            - numero
                            - bairro
                            - municipio
                            - uf
                          additionalProperties: false
                      required:
                        - razao_social
                        - cpf_cnpj
                        - endereco
                      additionalProperties: false
                    servico:
                      type: object
                      properties:
                        descricao:
                          type: string
                        codigo_cnae:
                          type: string
                        codigo_item_lista:
                          type: string
                      required:
                        - codigo_cnae
                        - codigo_item_lista
                      additionalProperties: false
                    nbs:
                      type: object
                      properties:
                        codigo:
                          type: string
                        cst:
                          type: string
                        ct:
                          type: string
                        indop:
                          type: string
                      additionalProperties: false
                  required:
                    - id
                    - codigo_externo
                    - valor_servicos
                    - iss
                    - rps
                    - nfse
                    - tomador
                    - servico
                    - nbs
                  additionalProperties: false
                minItems: 0
          description: OK
        '401':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - 'HTTP Basic: Access denied.'
                required:
                  - error
                additionalProperties: false
          description: Unauthorized
        '422':
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    enum:
                      - invalid_params
                  params:
                    description: An object containing error messages for all invalid params
                    type: object
                    additionalProperties:
                      type: string
                required:
                  - error
                  - params
                additionalProperties: false
          description: Unprocessable Content
      security:
        - basicAuth: []
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic

````