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

# Consultar faixas de distância da dinâmica

> Retorna as faixas de distância da dinâmica da área, com o valor base de cada faixa e os valores por categoria. Área sem faixas devolve `faixas` vazia; o valor dela é o de `GET /dinamicas/area`.

`versao` identifica a configuração vigente e muda a cada alteração de valores, faixas ou tipo de cálculo, por qualquer canal. Ativar ou desativar a área não muda a `versao`. Envie-a no `PUT` para não sobrescrever uma alteração feita depois da sua leitura.

`categorias_elegiveis` lista as categorias que aceitam valor próprio, na ordem em que a central as vê, e vem vazia quando a central não tem valor por categoria liberado.

Na área com valores por categoria, a categoria de `categorias_elegiveis` que não aparece em `valores`, como uma criada depois da última alteração, fica sem dinâmica nesta área até entrar num `PUT`.

Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo da bandeira.



## OpenAPI

````yaml pages/v2/openapi-corridas.json GET /dinamicas/area/{id}/faixas
openapi: 3.1.0
info:
  title: API de Integração
  description: API de Integração v2 - Corridas
  license:
    name: MIT
  version: 2.0.0
servers:
  - url: https://api-vendas.taximachine.com.br/api/v2/integracao
  - url: https://api.taximachine.com.br/api/v2/integracao
security:
  - basicAuth: []
    ApiKeyAuth: []
paths:
  /dinamicas/area/{id}/faixas:
    get:
      summary: Consultar faixas de distância da dinâmica
      description: >-
        Retorna as faixas de distância da dinâmica da área, com o valor base de
        cada faixa e os valores por categoria. Área sem faixas devolve `faixas`
        vazia; o valor dela é o de `GET /dinamicas/area`.


        `versao` identifica a configuração vigente e muda a cada alteração de
        valores, faixas ou tipo de cálculo, por qualquer canal. Ativar ou
        desativar a área não muda a `versao`. Envie-a no `PUT` para não
        sobrescrever uma alteração feita depois da sua leitura.


        `categorias_elegiveis` lista as categorias que aceitam valor próprio, na
        ordem em que a central as vê, e vem vazia quando a central não tem valor
        por categoria liberado.


        Na área com valores por categoria, a categoria de `categorias_elegiveis`
        que não aparece em `valores`, como uma criada depois da última
        alteração, fica sem dinâmica nesta área até entrar num `PUT`.


        Requer Api-Key (bandeira) + autenticação HTTP Basic de um gestor ativo
        da bandeira.
      parameters:
        - name: id
          in: path
          required: true
          description: Identificador da área da dinâmica.
          schema:
            type: integer
            example: 10
      responses:
        '200':
          description: Sucesso
          content:
            application/json:
              schema:
                type: object
              example:
                success: true
                data:
                  id: 10
                  versao: 59602987
                  tipo_calculo: M
                  faixas:
                    - km_minimo: 0
                      km_maximo: 5
                      valor: 1.2
                      valores:
                        '12': 1.2
                        '13': 1.4
                    - km_minimo: 5
                      km_maximo: null
                      valor: 1.6
                      valores:
                        '12': 1.6
                        '13': 1.9
                  categorias_elegiveis:
                    - id: 12
                      nome: Moto
                    - id: 13
                      nome: Carro
        '404':
          description: Dinâmica não encontrada
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: 0
                    message: Dinâmica não encontrada.
        '500':
          description: Erro interno
          content:
            application/json:
              schema:
                type: object
              example:
                success: false
                errors:
                  - code: 0
                    message: Falha na operação
components:
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
    ApiKeyAuth:
      type: apiKey
      in: header
      name: api-key
      description: Obrigatório. Sua chave API.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.