Base Operations Base Score API

The Base Score API from Base Operations — 9 operation(s) for base score.

Operations 9

GET /v1/public/base-scores Get aggregate BaseScore for a city using a city id #
GET /v1/public/base-scores/radius Get aggregate BaseScore for a given radius using location coordinates #
GET /v1/public/base-scores/hex Get aggregate BaseScore for a hex using a hex id #
GET /v1/public/base-scores/saved-locations/{savedLocationId} Get aggregate BaseScore for a given radius using a saved location id #
GET /v1/public/base-scores/saved-locations/{savedLocationId}/location Get aggregate BaseScore for a city using a city id #
GET /v1/public/base-scores/saved-locations/{savedLocationId}/categories Get the BaseScore category breakdown within a specified radius using a saved… #
GET /v1/public/base-scores/categories Get the BaseScore category breakdown within a specified city using a city id #
GET /v1/public/base-scores/radius/categories Get the BaseScore category breakdown within a specified radius using location… #
GET /v1/public/base-scores/hex/categories Get the BaseScore category breakdown within a specified hex using a hex id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/base-operations-base-score-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

base-operations-base-score-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Customer API - Base Operations Base Score API
  description: Welcome to the Base Operations Customer API!
  version: '1.0'
  contact: {}
servers:
- url: https://api.baseoperationsenterprise.com/
tags:
- name: Base Score
paths:
  /v1/public/base-scores:
    get:
      operationId: PublicBaseScoreController_getThreatScoreLocation_v1
      parameters:
      - name: locationId
        required: true
        in: query
        schema:
          type: number
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get aggregate BaseScore for a city using a city id
      tags:
      - Base Score
  /v1/public/base-scores/radius:
    get:
      description: 'This endpoint computes the base score for a given radius. The query dto should include the following fields:


        - The `latitude`, `longitude`, and `radius` are required parameters to define the area of interest.


        - The `units` parameter is used to specify the measurement unit of the radius.


        - The `normalizedBy` parameter is used to specify the normalization method for the base score either through area or populateion.'
      operationId: PublicBaseScoreController_getThreatScoreRadius_v1
      parameters:
      - name: latitude
        required: true
        in: query
        schema:
          type: number
      - name: longitude
        required: true
        in: query
        schema:
          type: number
      - name: radius
        required: true
        in: query
        schema:
          type: number
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      - name: units
        required: true
        in: query
        description: 'NB: miles, kilometers and meters will be deprecated soon.'
        schema:
          default: mi
          type: string
          enum:
          - mi
          - km
          - m
          - miles
          - kilometers
          - meters
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get aggregate BaseScore for a given radius using location coordinates
      tags:
      - Base Score
  /v1/public/base-scores/hex:
    get:
      operationId: PublicBaseScoreController_getThreatScoreHexes_v1
      parameters:
      - name: hexIds
        required: true
        in: query
        schema:
          type: array
          items:
            type: string
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get aggregate BaseScore for a hex using a hex id
      tags:
      - Base Score
  /v1/public/base-scores/saved-locations/{savedLocationId}:
    get:
      description: This endpoint computes the base score of the radius of a saved location. Radius defaults to `0.5 mi`.
      operationId: PublicBaseScoreController_getSavedLocationsRadiusThreatScore_v1
      parameters:
      - name: savedLocationId
        required: true
        in: path
        schema:
          type: number
      - name: units
        required: true
        in: query
        description: 'NB: miles, kilometers and meters will be deprecated soon.'
        schema:
          default: mi
          type: string
          enum:
          - mi
          - km
          - m
          - miles
          - kilometers
          - meters
      - name: radius
        required: true
        in: query
        schema:
          default: 0.5
          type: number
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Saved location not found | Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get aggregate BaseScore for a given radius using a saved location id
      tags:
      - Base Score
  /v1/public/base-scores/saved-locations/{savedLocationId}/location:
    get:
      deprecated: true
      description: This endpoint computes the base score for a saved location. Granularity is defaults to `city`.
      operationId: PublicBaseScoreController_getSavedLocationsLocationThreatScore_v1
      parameters:
      - name: savedLocationId
        required: true
        in: path
        schema:
          type: number
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Saved location not found | Location not found | Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get aggregate BaseScore for a city using a city id
      tags:
      - Base Score
  /v1/public/base-scores/saved-locations/{savedLocationId}/categories:
    get:
      operationId: PublicBaseScoreController_getSavedLocationsRadiusCategories_v1
      parameters:
      - name: savedLocationId
        required: true
        in: path
        schema:
          type: number
      - name: units
        required: true
        in: query
        description: 'NB: miles, kilometers and meters will be deprecated soon.'
        schema:
          default: mi
          type: string
          enum:
          - mi
          - km
          - m
          - miles
          - kilometers
          - meters
      - name: radius
        required: true
        in: query
        schema:
          default: 0.5
          type: number
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '401':
          description: Unauthorized. Your API Key may be invalid or expired.
        '404':
          description: Saved location not found | Base Score is not available.
        '500':
          description: Internal Server Error
      security:
      - ApiKey: []
      summary: Get the BaseScore category breakdown within a specified radius using a saved…
      tags:
      - Base Score
  /v1/public/base-scores/categories:
    get:
      operationId: PublicBaseScoreController_getScoreCategoriesByLocation_v1
      parameters:
      - name: locationId
        required: true
        in: query
        schema:
          type: number
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ThreatCategoriesDownloadData'
      security:
      - ApiKey: []
      summary: Get the BaseScore category breakdown within a specified city using a city id
      tags:
      - Base Score
  /v1/public/base-scores/radius/categories:
    get:
      operationId: PublicBaseScoreController_getScoreCategoriesByRadius_v1
      parameters:
      - name: latitude
        required: true
        in: query
        schema:
          type: number
      - name: longitude
        required: true
        in: query
        schema:
          type: number
      - name: radius
        required: true
        in: query
        schema:
          type: number
      - name: units
        required: true
        in: query
        schema:
          type: string
          enum:
          - km
          - mi
          - m
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ThreatCategoriesDownloadData'
      security:
      - ApiKey: []
      summary: Get the BaseScore category breakdown within a specified radius using location…
      tags:
      - Base Score
  /v1/public/base-scores/hex/categories:
    get:
      operationId: PublicBaseScoreController_getScoreCategoriesByHexes_v1
      parameters:
      - name: hexIds
        required: true
        in: query
        schema:
          type: array
          items:
            type: string
      - name: categories
        required: false
        in: query
        schema:
          type: array
          items:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ThreatCategoriesDownloadData'
      security:
      - ApiKey: []
      summary: Get the BaseScore category breakdown within a specified hex using a hex id
      tags:
      - Base Score
components:
  schemas:
    ThreatCategoriesDownloadData:
      type: object
      properties:
        categoryId:
          type: number
        category:
          type: string
        score:
          type: number
      required:
      - categoryId
      - category
      - score
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-API-KEY