---
title: Quais os possíveis códigos de erro da Toll for Maps API?
description: Conheça os status codes para cada endpoint e os possíveis erros que podem ser retornados pela Toll for Ma API.
---

[Pular para o conteúdo](https://knowledge.maplink.global/migration/pt-br/base/quais-os-possíveis-códigos-de-erro-da-toll-for-maps-api#main-content)

Português - Brasil

Mostrar submenu para traduções

[Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new?hsLang=pt-br) [Portal do cliente](https://knowledge.maplink.global/customers?hsLang=pt-br)

![logo\_maplink-1.png\]](https://knowledge.maplink.global/hs-fs/hubfs/logo_maplink-1.png?height=40&name=logo_maplink-1.png)

Abrir navegação principal

Fechar navegação principal

- Português - Brasil
  
  Mostrar submenu para traduções
- [Abrir chamado](https://knowledge.maplink.global/migration/pt-br/base/kb-tickets/new)
- [Portal do cliente](https://knowledge.maplink.global/customers)
- Ir para maplink.global

 Ir para maplink.global

 Olá. Como podemos ajudá-lo?

- Não há sugestões porque o campo de pesquisa está em branco.

1. [Centro de ajuda](https://knowledge.maplink.global/migration/pt-br/base?hsLang=pt-br)
2. [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br)
3. [Toll for Maps API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-for-maps-api)

# Quais os possíveis códigos de erro da Toll for Maps API?

## Conheça os status codes para cada endpoint e os possíveis erros que podem ser retornados pela Toll for Ma API.

Abaixo a tabela com os *status codes* para cada endpoint disponível na Toll for Maps API:

| **Código** | **Método** | **Endpoint** | **Descrição** |
| --- | --- | --- | --- |
| 200 | POST | [https://api.maplink.global/toll/v1/directions](https://api.maplink.global/toll/v1/directions) | OK (cálculo realizado) |
| 400 | POST | [https://api.maplink.global/toll/v1/directions](https://api.maplink.global/toll/v1/directions) | Error: Bad Request (falta de parâmetros, envio incompleto ou requisição com erros) |
| 500 | POST | [https://api.maplink.global/toll/v1/directions](https://api.maplink.global/toll/v1/directions) | An Internal Server Error occurred (erro interno no processamento da requisição) |

 

A tabela a seguir mostra todas as mensagens de erro que podem ser retornadas pela API no *body* da resposta:

| **Código de erro** | **Mensagem** | **Descrição** |
| --- | --- | --- |
| VALIDATION\_FAILED ou VALIDATION\_ERROR | { message: "", errors: \[ \] } | Erros de validação simples, o array errors contém a mensagem detalhada para cada campo contendo valor inválido (exemplo: "tripProfile is mandatory" indica que este campo é obrigatório mas não foi informado) |
| MESSAGE\_FORMAT\_ERROR | - | O json da request possui erros e não pôde ser processado |
| Validation failed | travel\_mode does not have a valid value. Allowed values: \[DRIVING\] | O body enviado contém travel\_mode diferente de DRIVING. |
| Validation failed | vehicleType does not have a valid value. | Foi passado um valor diferente em vehicleType. Allowed values: \[CAR, MOTORCYCLE, CAR\_WITH\_THREE\_SIMPLE\_AXLES, CAR\_WITH\_FOUR\_SIMPLE\_AXLES, BUS\_WITH\_TWO\_DOUBLE\_AXLES, BUS\_WITH\_THREE\_DOUBLE\_AXLES, BUS\_WITH\_FOUR\_DOUBLE\_AXLES, BUS\_WITH\_FIVE\_DOUBLE\_AXLES, TRUCK\_WITH\_TWO\_SINGLE\_AXIS, TRUCK\_WITH\_TWO\_DOUBLE\_AXLES, TRUCK\_WITH\_THREE\_DOUBLE\_AXLES, TRUCK\_WITH\_FOUR\_DOUBLE\_AXLES, TRUCK\_WITH\_FIVE\_DOUBLE\_AXLES, TRUCK\_WITH\_SIX\_DOUBLE\_AXLES, TRUCK\_WITH\_SEVEN\_DOUBLE\_AXLES, TRUCK\_WITH\_EIGHT\_DOUBLE\_AXLES, TRUCK\_WITH\_NINE\_DOUBLE\_AXLES\] |

- [APIs Maplink Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#main-content)

    - [Planning API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#planning-api)
    - [Trip API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#trip-api)
    - [Toll API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-api)
    - [Toll for Maps API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#toll-for-maps-api)
    - [Distance Matrix API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#distance-matrix-api)
    - [CO2 API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#co2-api)
    - [Restriction Zone API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#restriction-zone-api)
    - [Geocode API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#geocode-api)
    - [Freight API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#freight-api)
    - [Tracking API](https://knowledge.maplink.global/migration/pt-br/base/apis-maplink-platform?hsLang=pt-br#tracking-api)
- [APIs Google Maps Platform](https://knowledge.maplink.global/migration/pt-br/base/apis-google-maps-platform?hsLang=pt-br)
- [Webinar e Workshop](https://knowledge.maplink.global/migration/pt-br/base/webinar-e-workshop?hsLang=pt-br)

[![](https://knowledge.maplink.global/hs-fs/hubfs/logo-maplink-novo-horizontal-colorido%20PNG.png?width=2190&height=540&name=logo-maplink-novo-horizontal-colorido%20PNG.png)](http://maplink.global)

Centro de ajuda maplink.global

Copyright © 2026, Maplink Cloud