---
title: "Listar Loggi Pontos."
method: POST
path: "/dropoff/locations"
tags: ["DropoffLocationsAPI"]
---

# Listar Loggi Pontos.

`POST /dropoff/locations`

Lista os Loggi Pontos disponíveis para dropoff.
### Teste abaixo o endpoint</h2> <div class="warning-docs">
  ⚠️ <em>Os campos abaixo precisam ser preenchidos para realização dos testes de endpoint.</em>
</div>

## Request body

- ListDropoffLocationsRequest — Filtros desejados para a listagem de Loggi Pontos.
  - `categories` string[], required — As **categorias** representam o agrupamento que nossa equipe de negócios faz do tipo de serviço que o Loggi Ponto fornece, ou a categoria na qual queremos inserir esse Loggi Ponto. Os pontos devem ser filtrados por **Perfil** (Profissional ou Comercial) e **Serviço**, sendo possível utilizar categorias de maneira simultânea para resultados com interseção. **Categorias de Perfil:** - **Ponto Profissional**: Inclui *Leves* e *Agências*. - **Ponto Comercial**: Inclui *LoggiPonto Terceiro*. - **LoggiPonto**: Inclui todos os pontos. *Esta é a categoria padrão*. **Categorias de Serviço:** - **DropOff Sem Etiqueta** - **DropOff** - **Reversa** Utilize as categorias de perfil e serviço conforme necessário para refinar sua busca. Por exemplo, para obter pontos comerciais que oferecem o serviço de *DropOff*, inclua ambas as categorias no filtro.
  - `limit` integer, nullable — Quantidade máxima de Loggi Pontos a serem retornados por página.
  - `offset` integer, nullable — Posição do primeiro Loggi Ponto a ser retornado.
  - `location_id` string, nullable — Filtro por identificador único para retornar um Loggi Ponto específico.
  - `postal_code` string, nullable — Filtro por proximidade de CEP.
  - `country` string, nullable — Filtro por país.
  - `city` string, nullable — Filtro de cidade.
  - `state` string, nullable — Filtro por estado.
  - `longitude` number, nullable — Filtro por longitude.
  - `latitude` number, nullable — Filtro por latitude.
  - `distance` number, nullable — Filtro por distância (em metros).

## Response `200`

Loggi Pontos retornados com sucesso.

- ListDropoffLocationsResponse — Resposta com os Loggi Pontos filtrados.
  - `status` 'success', required — Informa que houve sucesso na pesquisa.
  - `message` ListDropoffLocationsMessage — Paginação dos resultados.
    - `limit` integer, required — Quantidade máxima de Loggi Pontos por página.
    - `offset` integer, required — Posição do primeiro Loggi Ponto na página atual.
    - `current_page` integer, required — Página atual.
    - `total_pages` integer, required — Quantidade total de páginas.
    - `total_locations` integer, required — Quantidade total de Loggi Pontos encontrados.
    - `pagination` DropoffLocation[], required — Lista dos Loggi Pontos presentes na página atual.
      - `location_id` string — Identificador único do Loggi Ponto.
      - `location_name` string — Nome do Loggi Ponto.
      - `location_type` string — Tipo do Loggi Ponto.
      - `categories` string[] — Categorias do Loggi Ponto.
      - `available_compartments` unknown
      - `longitude` number — Longitude do Loggi Ponto.
      - `latitude` number — Latitude
      - `country` string — Páis do Loggi Ponto.
      - `city` string — Cidade do Loggi Ponto.
      - `district` string — Distrito do Loggi Ponto.
      - `postal_code` string — CEP do Loggi Ponto.
      - `address` string — Endereço do Loggi Ponto.
      - `neighborhood` string — Bairro.
      - `state` string — Estado.
      - `complement` string — Complemento.
      - `opening_hours` string — Horário de funcionamento.
      - `opening_hours_detail` string — Horário de funcionamento.
      - `navigation_link` unknown
      - `special_holidays` unknown
      - `site_condition` unknown
      - `opening_hours_details` OpeningHoursDay[] — Horário de funcionamento.
        - `day` string — Dia da semana.
        - `open` string — Hora de abertura.
        - `close` string — Hora de fechamento.

## Other responses

- `400` — Requisição não segue a especificação.
- `401` — Falha de autenticação
- `429` — Requisições massivas bloqueadas.
- `500` — Erro interno
- `503` — Serviço temporariamente indisponível.

---

[API](https://skmtc.net/loggi/apis/authentication.md) · [All operations](https://skmtc.net/loggi/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loggi/authentication/revisions/46512f6e2419/schema)
