---
title: "Localização e Logradouro - Consultar por CEP."
url: "https://devcenter.stone.com.br/apis/stone-tax/versions/206fd1c1-6382-4ada-8612-c67fdc65e050/paths/api-v1-RecursosAdicionais-Cep-cep--Consultar/get"
---

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

# Localização e Logradouro - Consultar por CEP.

`GET` `/api/v1/RecursosAdicionais/Cep/{cep}/Consultar`

Realiza a busca detalhada de informações do logradouro com base no Código de Endereçamento Postal (CEP). Este recurso é essencial para a <strong>padronização de cadastros</strong> de clientes, fornecedores e emissores, garantindo a integridade dos dados de localização. ⚠️ **ATENÇÃO**: O CEP informado deve conter apenas números (8 dígitos). 🔍 **DICA DE INTEGRAÇÃO**: Utilize este endpoint para o preenchimento automático de campos de endereço em interfaces de usuário, minimizando erros de digitação e facilitando o cálculo de alíquotas baseadas na localidade (ISS/ICMS).

## Path parameters

- `cep` (string, required) - CEP - Código de Endereçamento Postal.

## Header parameters

- `DocumentoEmissor` (string, optional) - Documento do emissor.

## Responses

- `200` - OK
- `400` - Bad Request
- `401` - Unauthorized
- `403` - Forbidden
- `404` - Not Found
- `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/RecursosAdicionais/Cep/{cep}/Consultar:
    get:
      tags:
        - RecursosAdicionais
      summary: Localização e Logradouro - Consultar por CEP.
      description: >-
        Realiza a busca detalhada de informações do logradouro com base no
        Código de Endereçamento Postal (CEP). 

        Este recurso é essencial para a <strong>padronização de
        cadastros</strong> de clientes, fornecedores e emissores, garantindo a
        integridade dos dados de localização.


        ⚠️ **ATENÇÃO**: O CEP informado deve conter apenas números (8 dígitos).


        🔍 **DICA DE INTEGRAÇÃO**: Utilize este endpoint para o preenchimento
        automático de campos de endereço em interfaces de usuário, minimizando
        erros de digitação e facilitando o cálculo de alíquotas baseadas na
        localidade (ISS/ICMS).
      parameters:
        - name: cep
          in: path
          description: CEP - Código de Endereçamento Postal.
          required: true
          schema:
            type: string
        - name: DocumentoEmissor
          in: header
          description: Documento do emissor.
          schema:
            type: string
      responses:
        "200":
          description: OK
          content:
            text/plain:
              schema:
                $ref: "#/components/schemas/ConsultaCepViewModel"
            application/json:
              schema:
                $ref: "#/components/schemas/ConsultaCepViewModel"
            text/json:
              schema:
                $ref: "#/components/schemas/ConsultaCepViewModel"
        "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"
        "404":
          description: Not Found
          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:
    ConsultaCepViewModel:
      type: object
      properties:
        cep:
          type: string
          description: Código de Endereçamento Postal.
          nullable: true
        logradouro:
          type: string
          description: Nome da rua, avenida ou logradouro.
          nullable: true
        complemento:
          type: string
          description: Informações adicionais do endereço.
          nullable: true
        bairro:
          type: string
          description: Bairro onde se localiza o logradouro.
          nullable: true
        localidade:
          type: string
          description: Nome da cidade ou localidade.
          nullable: true
        uf:
          type: string
          description: Unidade Federativa (Estado).
          nullable: true
        ibge:
          type: string
          description: Código do município no IBGE.
          nullable: true
      additionalProperties: false
      description: Dados detalhados da consulta de endereço via CEP.
    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
  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
```