2020 Police Brutality Incidents API

openapi: 3.0.3
info:
  title: 2020 Police Brutality Incidents API
  description: This repository accumulates and contextualizes evidence of police brutality during the 2020 George Floyd protests. The data is available as static JSON files from the data_build branch, providing location-based incident records for use by journalists, politicians, prosecutors, activists, and concerned individuals. Generated from documentation.
  version: '2.0'
  license:
    name: MIT
    url: https://github.com/2020PB/police-brutality/blob/main/LICENSE
  contact:
    url: https://github.com/2020PB/police-brutality
  x-generated-from: documentation
servers:
- url: https://raw.githubusercontent.com/2020PB/police-brutality/data_build
  description: GitHub raw data files (data_build branch)
tags:
- name: Incidents
  description: Police brutality incident records from the 2020 George Floyd protests
paths:
  /all-locations.json:
    get:
      operationId: getAllIncidents
      summary: 2020 Police Brutality Get All Incidents
      description: Retrieve all documented police brutality incidents from the 2020 George Floyd protests. Returns a JSON object containing metadata and an array of incident records with location, date, description, tags, and source links.
      tags:
      - Incidents
      responses:
        '200':
          description: Successful response with all incident records
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IncidentCollection'
              examples:
                GetAllIncidents200Example:
                  summary: Default getAllIncidents 200 response
                  x-microcks-default: true
                  value:
                    edit_at: https://github.com/2020PB/police-brutality
                    help: https://github.com/2020PB/police-brutality/issues
                    updated_at: '2024-08-20T16:17:02Z'
                    data:
                    - id: nm-albuquerque-1
                      name: Student journalist struck by foam bullet
                      description: A student journalist was struck by a foam bullet while covering protests.
                      date: '2020-06-01'
                      date_text: June 1st
                      state: NM
                      city: Albuquerque
                      geolocation: 35.0844,-106.6504
                      tags:
                      - foam-bullet
                      - journalist
                      links:
                      - https://example.com/source
                      edit_at: https://github.com/2020PB/police-brutality/edit/main/reports/New%20Mexico.md
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /all-locations-v2.json:
    get:
      operationId: getAllIncidentsV2
      summary: 2020 Police Brutality Get All Incidents V2
      description: Retrieve all documented police brutality incidents in version 2 format. Provides the same incident data as v1 with an updated schema structure for improved data consistency and additional fields.
      tags:
      - Incidents
      responses:
        '200':
          description: Successful response with all incident records in v2 format
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/IncidentCollection'
              examples:
                GetAllIncidentsV2200Example:
                  summary: Default getAllIncidentsV2 200 response
                  x-microcks-default: true
                  value:
                    edit_at: https://github.com/2020PB/police-brutality
                    help: https://github.com/2020PB/police-brutality/issues
                    updated_at: '2024-08-20T16:17:02Z'
                    data:
                    - id: nm-albuquerque-1
                      name: Student journalist struck by foam bullet
                      description: A student journalist was struck by a foam bullet while covering protests.
                      date: '2020-06-01'
                      date_text: June 1st
                      state: NM
                      city: Albuquerque
                      geolocation: 35.0844,-106.6504
                      tags:
                      - foam-bullet
                      - journalist
                      links:
                      - https://example.com/source
                      edit_at: https://github.com/2020PB/police-brutality/edit/main/reports/New%20Mexico.md
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /all-locations.csv:
    get:
      operationId: getAllIncidentsCsv
      summary: 2020 Police Brutality Get All Incidents as CSV
      description: Retrieve all documented police brutality incidents in CSV format. Provides tabular data suitable for spreadsheet analysis and data import.
      tags:
      - Incidents
      responses:
        '200':
          description: Successful response with all incident records in CSV format
          content:
            text/csv:
              schema:
                type: string
              example: 'id,name,description,date,state,city,geolocation,tags

                nm-albuquerque-1,Student journalist struck by foam bullet,...,2020-06-01,NM,Albuquerque,"35.0844,-106.6504",foam-bullet|journalist'
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
components:
  schemas:
    IncidentCollection:
      type: object
      description: Collection of police brutality incidents with metadata
      properties:
        edit_at:
          type: string
          format: uri
          description: URL to the GitHub repository for editing/contributing
          example: https://github.com/2020PB/police-brutality
        help:
          type: string
          format: uri
          description: URL to report issues or get help
          example: https://github.com/2020PB/police-brutality/issues
        updated_at:
          type: string
          format: date-time
          description: Timestamp of the last data update
          example: '2024-08-20T16:17:02Z'
        data:
          type: array
          description: Array of incident records
          items:
            $ref: '#/components/schemas/Incident'
    Incident:
      type: object
      description: A documented police brutality incident from the 2020 George Floyd protests
      properties:
        id:
          type: string
          description: 'Unique identifier for the incident (format: state-city-number)'
          example: nm-albuquerque-1
        name:
          type: string
          description: Brief title or summary of the incident
          example: Student journalist struck by foam bullet
        description:
          type: string
          description: Detailed description of what occurred during the incident
          example: A student journalist was struck by a foam bullet while covering protests near downtown.
        date:
          type: string
          format: date
          description: Date the incident occurred (ISO 8601 format)
          example: '2020-06-01'
        date_text:
          type: string
          description: Human-readable date description
          example: June 1st
        state:
          type: string
          description: US state abbreviation where the incident occurred
          example: NM
        city:
          type: string
          description: City where the incident occurred
          example: Albuquerque
        geolocation:
          type: string
          description: Latitude and longitude coordinates of the incident location
          example: 35.0844,-106.6504
        tags:
          type: array
          description: Categorical tags describing the type of incident or force used
          items:
            type: string
          example:
          - foam-bullet
          - journalist
          - protester
        links:
          type: array
          description: Source URLs documenting or referencing the incident
          items:
            type: string
            format: uri
          example:
          - https://example.com/news-article
          - https://twitter.com/example/status/123456
        edit_at:
          type: string
          format: uri
          description: Direct link to edit this incident record on GitHub
          example: https://github.com/2020PB/police-brutality/edit/main/reports/New%20Mexico.md