Ocorrências

Definições

Endpoint que os dados de ocorrências. Este é o endpoint principal da aplicação.

Endereço:

GET

/occurrences

Retorno do endpoint:

{
  "msg": "Success in filtering occurrences",
  "msgCode": "success",
  "code": 200,
  "pageMeta": {
    "page": 1,
    "take": 2,
    "itemCount": 6178,
    "pageCount": 3089,
    "hasPreviousPage": false,
    "hasNextPage": true
  },
  "data": [
    {
      "id": "a7bfebed-ce9c-469d-a656-924ed8248e95",
      "documentNumber": 12622,
      "address": "Av. Jardim Muribeca - Muribeca, Jaboatão dos Guararapes - PE, 54350-315, Brasil",
      "state": {
        "id": "813ca36b-91e3-4a18-b408-60b27a1942ef",
        "name": "Pernambuco"
      },
      "region": {
        "id": "758e86d0-b5e0-410d-b8d8-b7061299be1a",
        "region": "Nordeste",
        "state": "Pernambuco",
        "enabled": true
      },
      "city": {
        "id": "5bd3bfe5-4989-4bc3-a646-fe77a876fce0",
        "name": "JABOATAO DOS GUARARAPES"
      },
      "neighborhood": {
        "id": "60d7c5c7-1f97-4e04-9afd-11f4241c29d9",
        "name": "MURIBECA"
      },
      "subNeighborhood": null,
      "locality": null,
      "latitude": "-8.1576367000",
      "longitude": "-34.9696372000",
      "date": "2018-04-01T03:00:00.000Z",
      "policeAction": false,
      "agentPresence": false,
      "relatedRecord": null,
      "contextInfo": {
        "mainReason": {
          "id": "7751b6c6-116a-4207-b067-fa0acd2433da",
          "name": "Execução"
        },
        "complementaryReasons": [],
        "clippings": [
          {
            "id": "6af07088-5548-468f-8ba0-f64225115793",
            "name": "Feminicídio"
          }
        ],
        "massacre": false,
        "policeUnit": null
      },
      "transports": [],
      "victims": [
        {
          "id": "98635fee-6019-4022-81b8-ef9b8894f53e",
          "occurrenceId": "a7bfebed-ce9c-469d-a656-924ed8248e95",
          "type": "People",
          "situation": "Dead",
          "circumstances": [],
          "deathDate": "2018-04-01T03:00:00.000Z",
          "personType": "Civilian",
          "age": 22,
          "ageGroup": {
            "id": "1247dd9f-6796-495f-91c4-ca8d6db45c5e",
            "name": "Adulto"
          },
          "genre": {
            "id": "cd8372e3-a8bf-4e61-85b4-cbb62e13bb36",
            "name": "Feminino"
          },
          "race": null,
          "place": {
            "id": "e5c2090b-694f-4ff9-8f53-66a496193319",
            "name": "Sem identificação"
          },
          "serviceStatus": {
            "id": "526e2e79-bbc7-48a0-9858-fd05084fedd7",
            "name": "Não identificado",
            "type": "Servico"
          },
          "qualifications": [],
          "politicalPosition": {
            "id": "84bb4841-1cac-4592-ba57-21714aa84454",
            "name": "Não se aplica",
            "type": "Politico"
          },
          "politicalStatus": {
            "id": "5238a823-cab9-47f5-85bc-34b810ae0d71",
            "name": "Não se aplica",
            "type": "Politico"
          },
          "partie": null,
          "coorporation": {
            "id": "52e03783-cb08-49b5-8635-0d462773e250",
            "name": "Não se aplica"
          },
          "agentPosition": null,
          "agentStatus": {
            "id": "940eb1bd-6f7f-4f73-9d6e-b44eb4fdd791",
            "name": "Não se aplica",
            "type": "Agente"
          },
          "unit": ""
        }
      ],
      "animalVictims": []
    },
    {
      "id": "a14d18dd-b28f-4c30-af07-5fa40d88b3f7",
      "documentNumber": 12623,
      "address": "Pixete, São Lourenço da Mata - PE, Brasil",
      "state": {
        "id": "813ca36b-91e3-4a18-b408-60b27a1942ef",
        "name": "Pernambuco"
      },
      "region": {
        "id": "758e86d0-b5e0-410d-b8d8-b7061299be1a",
        "region": "Nordeste",
        "state": "Pernambuco",
        "enabled": true
      },
      "city": {
        "id": "3d11bf52-0213-4d6f-a607-77f172cbe3b6",
        "name": "SAO LOURENCO DA MATA"
      },
      "neighborhood": {
        "id": "a1018fde-b487-4a0d-90a5-37c75daae09e",
        "name": "TIUMA"
      },
      "subNeighborhood": null,
      "locality": null,
      "latitude": "-7.9800434000",
      "longitude": "-35.0553350000",
      "date": "2018-04-01T03:00:00.000Z",
      "policeAction": false,
      "agentPresence": false,
      "relatedRecord": null,
      "contextInfo": {
        "mainReason": {
          "id": "baa3b299-67ad-41d2-aaf0-23ec8288cadb",
          "name": "Homicidio/Tentativa"
        },
        "complementaryReasons": [],
        "clippings": [],
        "massacre": false,
        "policeUnit": null
      },
      "transports": [],
      "victims": [
        {
          "id": "32fe246b-0cb1-4c08-b6d3-f6dcf7792058",
          "occurrenceId": "a14d18dd-b28f-4c30-af07-5fa40d88b3f7",
          "type": "People",
          "situation": "Dead",
          "circumstances": [],
          "deathDate": "2018-04-01T03:00:00.000Z",
          "personType": "Civilian",
          "age": null,
          "ageGroup": {
            "id": "1247dd9f-6796-495f-91c4-ca8d6db45c5e",
            "name": "Adulto"
          },
          "genre": {
            "id": "bd0504ee-e0b5-4ae1-ae12-b6d9c61802e1",
            "name": "Masculino"
          },
          "race": null,
          "place": {
            "id": "e5c2090b-694f-4ff9-8f53-66a496193319",
            "name": "Sem identificação"
          },
          "serviceStatus": {
            "id": "7304cf1f-f7a3-4108-87b8-edf8f99a56c0",
            "name": "Não se aplica",
            "type": "Servico"
          },
          "qualifications": [],
          "politicalPosition": {
            "id": "84bb4841-1cac-4592-ba57-21714aa84454",
            "name": "Não se aplica",
            "type": "Politico"
          },
          "politicalStatus": {
            "id": "5238a823-cab9-47f5-85bc-34b810ae0d71",
            "name": "Não se aplica",
            "type": "Politico"
          },
          "partie": null,
          "coorporation": {
            "id": "52e03783-cb08-49b5-8635-0d462773e250",
            "name": "Não se aplica"
          },
          "agentPosition": null,
          "agentStatus": {
            "id": "940eb1bd-6f7f-4f73-9d6e-b44eb4fdd791",
            "name": "Não se aplica",
            "type": "Agente"
          },
          "unit": ""
        }
      ],
      "animalVictims": []
    }
  ]
}

Exemplos de Transformação para Formato CSV

Abaixo, você encontrará links para download de exemplos de arquivos CSV que demonstram a utilização dos dados obtidos com base no exemplo acima.

O exemplo "Completo" representa uma transformação integral dos dados retornados pela API para um formato CSV, sem aplicar nenhum tratamento de dados específico. Neste caso, cada campo:valor será convertido em coluna|valor.
Download do exemplo Completo

O exemplo "Transformado" oferece uma visão mais prática de como os dados retornados pela API podem ser empregados para obter informações mais diretas, como, por exemplo, o número de fatalidades em um incidente.
Download do exemplo Transformado

💡

Os exemplos "Completo" e "Transformado" são meramente ilustrativos, demonstrando como o conteúdo retornado pelo endpoint de ocorrências pode ser usado para a geração de dados. O uso deste endpoint, no entanto, não está restrito a esses dois exemplos.

Abaixo o que cada campo representa

Campo	Valor
id	Identificador único da ocorrência
documentNumber	Número da ocorrência
address	Endereço da ocorrência
state	Estado da ocorrência
region	Região da ocorrência
city	Cidade da ocorrência
neighborhood	Bairro da ocorrência
subNeighborhood	Sub-bairro da ocorrência
locality	Localidade específica da ocorrência
latitude	Latitude do local da ocorrência
longitude	Longitude do local da ocorrência
date	Data e hora da ocorrência
policeAction	Indica se houve ação policial durante a ocorrência
agentPresence	Indica se havia agentes de segurança presentes durante a ocorrência, dentro ou fora de serviço
relatedRecord	Registro relacionado da ocorrência
contextInfo	Informações adicionais sobre o contexto da ocorrência
transports	Informações sobre interrupções de transporte relacionadas à ocorrência
victims	Informações sobre as vítimas da ocorrência
animalVictims	Informações sobre animais vítimas durante a ocorrência

1. Informações de contexto: contextInfo

Campo	Valor
mainReason	Motivo principal da ocorrência
complementaryReasons	Motivos complementares que contribuíram para a ocorrência
clippings	Recortes relevantes relacionados à ocorrência
massacre	Indica se a ocorrência é classificada como uma chacina (verdadeiro/falso)
policeUnit	Nome da unidade policial envolvida na ocorrência

2. Transportes relacionados a ocorrência: transports

Campo	Valor
id	Identificador único do relacionamento transporte ocorrência
occurrenceId	Identificador da ocorrência relacionada ao transporte
transport	Tipo de transporte afetado pela ocorrência
interruptedTransport	Indica se o transporte foi interrompido devido à ocorrência (verdadeiro/falso)
dateInterruption	Data e hora em que o transporte foi interrompido
releaseDate	Data e hora em que o transporte foi retomado
transportDescription	Descrição adicional sobre como a ocorrência afetou o transporte

3. Vítimas humanas: victims

Campo	Valor
id	Identificador único da vítima
occurrenceId	Identificador da ocorrência relacionada à vítima
type	Tipo de vítima (neste caso, 'People')
situation	Situação da vítima (por exemplo, morta, ferida)
circumstances	Circunstâncias que levaram ao estado da vítima
deathDate	Data e hora da morte da vítima, se aplicável
personType	Tipo de pessoa (por exemplo, Civil, Agente)
age	Idade da vítima
ageGroup	Grupo de idade ao qual a vítima pertence
genre	Gênero da vítima
race	Raça da vítima
place	Lugar onde a vítima foi encontrada ou afetada
serviceStatus	Status de serviço da vítima, se aplicável
qualifications	Qualificações ou características relevantes da vítima
politicalPosition	Cargo político da vítima, se aplicável
politicalStatus	Status do cargo político da vítima, se aplicável
partie	Partido político ao qual a vítima pertence, se aplicável
coorporation	Corporação à qual a vítima pertence, se aplicável
agentPosition	Cargo de agente de segurança ocupado pela vítima, se aplicável
agentStatus	Status de serviço da vítima, se aplicável
unit	Unidade à qual a vítima pertence, se aplicável

4. Vítimas animais: animalVictims

Campo	Valor
id	Identificador único da vítima animal
occurrenceId	Identificador da ocorrência relacionada à vítima animal
name	Nome do animal, se conhecido
type	Tipo de vítima (neste caso, 'Animal')
animalType	Tipo de animal (por exemplo, Cachorro, Gato, Papagaio etc.)
situation	Situação da vítima animal (por exemplo, morta, ferida)
circumstances	Circunstâncias que levaram ao estado da vítima animal
deathDate	Data e hora da morte do animal, se aplicável

Tabela de Motivos (mainReason, complementaryReasons)

Motivo	Descrição
Ação policial	Ações de rotina. Incluem abordagens, rondas, patrulhamento, blitz, etc.
Arrastão	Assaltos, ou tentativa de assalto coletivas. Selecionados pela nomenclatura dada na matéria
Ataque a civis	Ataque a estabelecimentos civis como lojas, bares, pontos de ônibus, etc.
Briga	Brigas que resultam em disparos de arma de fogo
Disparo acidental	Tiros acidentais, como por exemplo crianças brincando com armas
Disputa	Confronto entre facções e/ou milícia – sem agentes de segurança em serviço. Termo utilizado para facilitar a categorização
Execução	Mortes em que a notícia deixar claro o viés de execução, ou em que houver multiplicidade de tiros na direção da vítima, caracterizando dinâmica de execução. Precisa estar associado a uma morte.
Homicídio/Tentativa	Qualquer morte ou tentativa de matar alguém em que a notícia não deixe explícito que foi execução, chacina ou suicídio. Usado quando há informações de que o motivo dos disparos é matar.
Não identificado	Motivo não identificado
Operação policial	Ações policiais não rotineiras, planejadas. Geralmente incluem mais de uma unidade policial. Sempre que houver participação de grupos especializados, p.ex: BOPE, Choque, Core, BAC, Gat, etc. Sempre que houver participação das FFAA
Outro	Quando soubermos o motivo, mas ele não se encaixar em nenhuma categoria já existente.
Rebelião/fuga de presos	Tiros em presídios e/ou no entorno deles causados por rebelião ou tentativa de fuga.
Sequestro/Cárcere privado	Casos de pessoas privadas de liberdade
Suicídio	Disparos de arma de fogo com a intenção de tirar a própria vida do autor dos disparos.
Tentativa/roubo	Qualquer roubo, ou tentativa de, que não seja caracterizado como arrastão e não inclua cargas ou bancos.
Tentativa/roubo a banco	Roubo ou tentativa de roubo a bancos (inclui caixas eletrônicos)
Tentativa/roubo de cargas	Roubo ou tentativa de roubo de cargas (inclui carro forte)
Tiros a esmo	Pessoas que passaram atirando sem direção, tiros pro alto, jogo de futebol, comemoração de aniversário ...etc.
Tortura	Disparos de arma de fogo com a intenção de torturar (infligir dor) a vítima

Tabela de Recortes (clippings)

Categoria	Definição
Ataque a político	Utilizado quando há políticos vítimas de disparos de arma de fogo (tenham eles sido baleados ou não - atentados mal sucedidos contam. Entenda-se por políticos: (i) pessoas que estão em cargos eletivos; (ii) pessoas que já tiveram cargos eletivos; (iii) pessoas que já concorreram a cargos eletivos mas não ganharam; (iv) pré-candidatos e candidatos a cargos eletivos; (v) assessores ou pessoas que ocupam cargos de confiança de políticos eleitos; (vi) cabos eleitorais declarados.
Ataques armados sob rodas	Situação em que ocupantes de veículos motorizados (carro, moto, kombi, van etc.) passam atirando contra um grupo de pessoas ou uma pessoa só. Não caracteriza como "ataque armado sob rodas": se os atiradores descem/saem do veículo antes de realizar os disparos; quando os atiradores abordam a(s) vítima(s) e, numa possível fuga, iniciam perseguição realizando disparos.
Bar	Qualquer espaço comercial privado que as pessoas se reúnam para beber
Feminicídio	Casos em que mulheres que foram assassinadas, ou sofreram tentativas de assassinato, em razão da condição de mulher. Incluem, mas não se limitam a casos de violência doméstica. É importante haver indicídios de crime de ódio. IMPORTANTE: nem toda morte de mulher será feminicídio
Outros	Categoria utilizada para adicionar opções que não se encaixam nas já existentes.
Perseguição	Perseguição, em veículos ou a pé, envolvendo disparos de arma de fogo
Presídio	Tiros dentro de unidades carcerárias (prisões, presídios e cadeias), com ou sem vítimas
Shopping	Tiros em estabelecimentos comerciais do tipo Shopping Center.
Tiros de helicópteros	Helicópteros utilizados como plataforma de tiros
Tiroteio contínuo	Tiroteios que tenham duração de 2 ou mais horas, com possíveis intervalos de 30 minutos.

Tabela de Qualificações (qualifications)

Categoria	Definição	Habilita status de serviço ?
Agente de segurança	Consideramos agentes de segurança: PM, PC, Guarda Municipal, Bombeiro, Agente Penitenciário, PF, PRF, FFAA e agentes de projetos públicos de segurança como segurança/bairro presente, na ativa - dentro ou fora de serviço -, aposentados ou reformados	Sim, específico
Político	Entenda-se por políticos: (i) pessoas que estão em cargos eletivos; (ii) pessoas que já tiveram cargos eletivos; (iii) pessoas que já concorreram a cargos eletivos mas não ganharam; (iv) pré-candidatos e candidatos a cargos eletivos; (v) assessores ou pessoas que ocupam cargos de confiança de políticos eleitos; (vi) cabos eleitorais declarados.	Sim, específico
Entregador / motoboy	Pessoa que presta serviços de entrega - comida, acessórios, documentos e produtos em geral - seja de motocicleta ou mesmo de bicicleta.	Sim
Motorista de aplicativo	Profissionais autônomos que trabalham para plataformas de transportes de pessoas em carros. A vítima deve ser o motorista de aplicativo, qualquer aplicativo. Não é utilizado para casos em que o motorista seja o autor dos disparos.	Sim
Mototaxista	Pessoa que presta serviço de transporte, que utiliza a motocicleta para transportar passageiros.	Sim
Outros	Categoria utilizada para adicionar opções que não se encaixam nas já existentes. Sempre que houver profissão identificada é obrigatório marcar OUTROS e descrever a profissão em `<observações>`	Sim
Rifeiro	Vendedores de rifas	Sim
Vendedor ambulante	Trabalhadores informais que comercializem produtos diversos nas ruas.	Sim
Ex-detento	Recorte utilizado para identificar pessoas que já foram submetidas a medidas de restrição de liberdade, mas não se encontram mais em regime fechado. É um recorte amplo e nome escolhido foi utilizado para simplificar. Valem adultos e adolescentes (medidas sócio-educativas) que se encontram nas seguintes situações: (i) presos em semi-aberto, (ii) liberdade condicional, (iii) pena cumrpida (ex-detentos), (iv) pessoas que foram presas provisoriamente e aguardam julgamento em liberdade, (v) pessoas que foram presas temporária ou provisioriamente mas já estão em liberdade, (vi) pessoas que a reportagem indica que "tiveram passagem pela polícia".	Não
Grávida	Mulheres grávidas	Não
Não identificado	-	Não

Exemplos de uso

Filtrando por várias cidades:

https://api-service.fogocruzado.org.br/api/v2/occurrences?order=ASC&page=1&take=20&idState=813ca36b-91e3-4a18-b408-60b27a1942ef&idCities=d79d2347-bd0d-40aa-8dcc-04134cffd988&idCities=e37f7ad7-cd64-4279-946a-8d689b9b934b (opens in a new tab)

Filtrando por data:

https://api-service.fogocruzado.org.br/api/v2/occurrences?initialdate=2023-01-01&finaldate=2023-07-13&idState=b112ffbe-17b3-4ad0-8f2a-2038745d1d14&typeOccurrence=withVictim (opens in a new tab)

Cidades