API Trilhos

Em estrita conformidade com as competências legais e atribuições fiscalizatórias da Agência Reguladora de Serviços Públicos Delegados de Transporte do Estado de São Paulo (ARTESP), informamos que, a partir de 03/09/2026, os dados e status fornecidos por esta API contemplam exclusivamente as concessionárias e linhas metroferroviárias sob fiscalização e regulação direta da ARTESP (malha delegada).

Os dados operacionais das linhas geridas diretamente por empresas públicas estaduais não integram mais a camada de dados exposta por este portal. Para solicitações, consultas ou informações sobre as demais linhas, os interessados devem acionar diretamente os canais oficiais e as Ouvidorias dos respectivos órgãos e operadoras responsáveis:

Companhia do Metropolitano de São Paulo (Metrô): www.metro.sp.gov.br / Ouvidoria e SIC
Companhia Paulista de Trens Metropolitanos (CPTM): www.cptm.sp.gov.br / Ouvidoria e SIC

Autenticação e Acesso

Desde 25/06/2026, o acesso a esta API é restrito a usuários autenticados. Para consumir os endpoints, é obrigatório solicitar uma chave de acesso (API Key) e fornecê-la em cada requisição.

Como solicitar acesso:

Faça login com a sua conta do portal e acesse a página de Minha Conta. Na seção Minhas APIs, você poderá solicitar acesso ao produto API Trilhos.

Cabeçalho de Autorização

Envie a chave no cabeçalho HTTP Authorization precedida pelo prefixo Api-Key :

Authorization: Api-Key cci_metro_status_live_<sua_chave>

Limites e Boas Práticas (Rate Limit)

O limite padrão desta API é de 12 requisições por hora por credencial.
Recomendamos a adoção de cache local no cliente e polling com intervalo máximo de uma chamada a cada 5 minutos.

Códigos de Resposta HTTP

401 Unauthorized Chave ausente, inválida, expirada, rotacionada ou de outro produto.

403 Forbidden IP de origem do cliente não permitido na allowlist da credencial.

429 Too Many Requests Limite de requisições excedido. Aguarde a redefinição da janela horária.

1. Status em Tempo Real

GET

Retorna o status operacional atualizado de todas as linhas.

https://ccm.artesp.sp.gov.br/metroferroviario/api/status/

Parâmetro	Tipo	Descrição
empresa	integer	ID da empresa (concessionária ou empresa pública)
linha	integer	ID único da linha

{
  "meta": {
    "versao": "1.1.0",
    "timestamp": "2024-01-28T10:30:00-03:00",
    "filtros_aplicados": { ... },
    "total_linhas": 16,
    "total_empresas": 4
  },
  "empresas": [
    {
      "id": 1,
      "nome": "ViaQuatro",
      "fiscalizacao_artesp": true,
      "linhas": [
        {
          "nome": "Linha 4-Amarela",
          "codigo": "4",
          "ativa": true,
          "status": {
            "situacao": "Operação Normal",
            "classificacao": "operacional",
            "operacao_normal": true,
            "atualizado_em": "...",
            "atualizado_ha": "5 minutos"
          },
          "estacoes": { "total": 11, "nomes": [...] }
        }
      ]
    }
  ]
}

2. Ocorrências Históricas

GET

Download do histórico completo de status operacional. Retorna todos os registros do período em uma única resposta (streaming).

https://ccm.artesp.sp.gov.br/metroferroviario/api/ocorrencias/?data_inicio=YYYY-MM-DD&data_fim=YYYY-MM-DD

Informações Importantes:

Período máximo de 365 dias por consulta
Bulk Download: Não utiliza paginação, entrega todos os dados de uma vez em formato JSON.

Parâmetro	Tipo	Descrição
data_inicio	string	Data inicial (YYYY-MM-DD). Default: 1 ano atrás.
data_fim	string	Data final (YYYY-MM-DD). Default: hoje.
empresa	integer	ID da empresa (Opcional)
linha	integer	ID da linha específica (Opcional)
classificacao	string	Lista de situações separadas por vírgula (Ex: Operação Normal, Velocidade Reduzida) (Opcional)

{
  "meta": {
    "versao": "1.1.0",
    "timestamp": "2026-06-24T11:15:00-03:00",
    "filtros_aplicados": {
      "data_inicio": "2026-06-24",
      "data_fim": "2026-06-24",
      "empresa": 1,
      "linha": null,
      "classificacao": null
    },
    "rate_limit": {
      "limite": 12,
      "janela": "1 hora"
    }
  },
  "ocorrencias": [
    {
      "id": 12345,
      "data_hora": "2026-06-24T08:30:00-03:00",
      "linha": {
        "id": "1",
        "nome": "Linha 4-Amarela",
        "codigo": "4"
      },
      "empresa": {
        "id": 1,
        "nome": "ViaQuatro",
        "fiscalizacao_artesp": true
      },
      "situacao": "Velocidade reduzida",
      "descricao": "Circulação de trens com velocidade reduzida devido a falha técnica.",
      "classificacao": {
        "tipo": "problema",
        "label": "Problema (Offline)",
        "conta_incidente": true
      }
    }
  ]
}

3. Lista de Empresas

GET

Lista todas as empresas operadoras e seus respectivos IDs.

https://ccm.artesp.sp.gov.br/metroferroviario/api/concessionarias/

{
  "meta": {
    "versao": "1.1.0",
    "timestamp": "2024-01-28T10:30:00-03:00",
    "total": 1
  },
  "empresas": [
    {
      "id": 1,
      "nome": "ViaQuatro",
      "fiscalizacao_artesp": true,
      "linhas": [
        {
          "nome": "Linha 4-Amarela",
          "codigo": "4"
        }
      ]
    }
  ]
}

Informações Gerais

Versão 1.1.0
Atualização A cada 5 min
Formato JSON (UTF-8)
Rate Limit Até 12 req/hora

Exemplo cURL

curl -H "Authorization: Api-Key cci_metro_status_live_<key_id>_<random>" "https://ccm.artesp.sp.gov.br/metroferroviario/api/status/"

Rate Limit Headers

X-RateLimit-Limit Total de requisições permitidas (1)

X-RateLimit-Remaining Requisições restantes na janela

Retry-After Segundos para próxima tentativa

Monitoramento

Infraestrutura

Informações