---
title: "Listar emissores."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-Emissor-Listar/get"
---

> Full API specification: https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050.md

# Listar emissores.

`GET` `/api/v1/Emissor/Listar`

Permite listar todos os emissores so aplicativo. O recurso possui filtros não obrigatórios e mecanismo de paginação.

## Query parameters

- `busca` (string, optional) - Filtrar por nome, documento ou identificador por texto.
- `documentoEmissor` (string, optional) - Filtrar pelo documento do emissor.
- `dataCriacaoInicial` (string, date-time, optional) - Filtrar pela data de criação inicial.
- `dataCriacaoFinal` (string, date-time, optional) - Filtrar pela data de criação final.
- `status` (string, optional) - Filtrar pelo status atual do emissor.
- `tipoDocumento` (string, optional) - Filtrar pelo tipo de documento.
- `regimeTributario` (array, optional) - Filtrar pela lista de regimes tributários.
- `estabelecimento` (string, optional) - Filtrar pelo tipo de estabelecimento.
- `offset` (integer, int32, optional) - Paginação da listagem - offset.
- `limit` (integer, int32, optional) - Paginação da listagem - limit.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `500` - Internal Server Error

## OpenAPI definition

```yaml
openapi: 3.0.4
info:
  title: Stone Tax API
  version: 1.0.0
servers:
  - url: https://stone-tax-sdx.stone.com.br
    description: Ambiente de Desenvolvimento
  - url: https://stone-tax.stone.com.br
    description: Ambiente de Produção
paths:
  /api/v1/Emissor/Listar:
    get:
      tags:
        - Emissor
      summary: Listar emissores.
      description: Permite listar todos os emissores so aplicativo. O recurso possui
        filtros não obrigatórios e mecanismo de paginação.
      parameters:
        - name: busca
          in: query
          description: Filtrar por nome, documento ou identificador por texto.
          schema:
            type: string
        - name: documentoEmissor
          in: query
          description: Filtrar pelo documento do emissor.
          schema:
            type: string
        - name: dataCriacaoInicial
          in: query
          description: Filtrar pela data de criação inicial.
          schema:
            type: string
            format: date-time
        - name: dataCriacaoFinal
          in: query
          description: Filtrar pela data de criação final.
          schema:
            type: string
            format: date-time
        - name: status
          in: query
          description: Filtrar pelo status atual do emissor.
          schema:
            $ref: "#/components/schemas/StatusEmissorModelEnum"
        - name: tipoDocumento
          in: query
          description: Filtrar pelo tipo de documento.
          schema:
            $ref: "#/components/schemas/TipoDocumentoEmissorModelEnum"
        - name: regimeTributario
          in: query
          description: Filtrar pela lista de regimes tributários.
          schema:
            type: array
            items:
              $ref: "#/components/schemas/RegimeTributarioModelEnum"
        - name: estabelecimento
          in: query
          description: Filtrar pelo tipo de estabelecimento.
          schema:
            $ref: "#/components/schemas/TipoEstabelecimentoEmissorModelEnum"
        - name: offset
          in: query
          description: Paginação da listagem - offset.
          schema:
            type: integer
            format: int32
            default: 1
        - name: limit
          in: query
          description: Paginação da listagem - limit.
          schema:
            type: integer
            format: int32
            default: 10
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/EmissorListagemViewModelListPaginationResponse"
            application/json:
              schema:
                $ref: "#/components/schemas/EmissorListagemViewModelListPaginationResponse"
            text/json:
              schema:
                $ref: "#/components/schemas/EmissorListagemViewModelListPaginationResponse"
        "400":
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "401":
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "403":
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
        "500":
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResponseErrorResult"
      security:
        - BearerAuth: []
security:
  - BearerAuth: []
components:
  schemas:
    StatusEmissorModelEnum:
      enum:
        - Inativo
        - Ativo
      type: string
      description: Status do emissor.
    TipoDocumentoEmissorModelEnum:
      enum:
        - Cpf
        - Cnpj
      type: string
      description: Tipo de documento do emissor.
    RegimeTributarioModelEnum:
      enum:
        - Mei
        - SimplesNacional
        - SimplesNacionalExcessoReceita
        - LucroPresumido
        - LucroReal
      type: string
      description: Regime tributário do emissor.
    TipoEstabelecimentoEmissorModelEnum:
      enum:
        - Outros
        - IndustriaOuEquiparado
      type: string
      description: Tipo de estabelecimento do emissor quanto ao IPI.
    EmissorListagemViewModelListPaginationResponse:
      type: object
      properties:
        offset:
          type: integer
          format: int32
        limit:
          type: integer
          format: int32
        total:
          type: integer
          format: int32
        data:
          type: array
          items:
            $ref: "#/components/schemas/EmissorListagemViewModel"
          nullable: true
      additionalProperties: false
    ResponseErrorResult:
      type: object
      properties:
        status:
          type: integer
          format: int32
        titulo:
          type: string
          nullable: true
        erros:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
          nullable: true
      additionalProperties: false
    EmissorListagemViewModel:
      type: object
      properties:
        documento:
          type: string
          description: Documento (CPF/CNPJ) do emissor.
          nullable: true
        tipoDocumento:
          $ref: "#/components/schemas/TipoDocumentoEmissorModelEnum"
        nome:
          type: string
          description: Nome ou Razão Social do emissor.
          nullable: true
        nomeFantasia:
          type: string
          description: Nome fantasia do emissor.
          nullable: true
        regimeTributario:
          $ref: "#/components/schemas/RegimeTributarioModelEnum"
        dataCriacao:
          type: string
          description: Data de criação do emissor no sistema.
          format: date-time
        ultimaAlteracao:
          type: string
          description: Data de última alteração dos dados do emissor no sistema.
          format: date-time
        status:
          $ref: "#/components/schemas/StatusEmissorModelEnum"
      additionalProperties: false
      description: Dados do emissor exibidos na listagem.
  securitySchemes:
    BearerAuth:
      type: http
      description: Autenticação via token JWT. Obtenha o token através do endpoint
        /Autenticacao/ObterToken usando Basic Auth. O token expira em 1 hora.
      scheme: bearer
      bearerFormat: JWT
```