UpGuard organisation API

The organisation API from UpGuard — 1 operation(s) for organisation.

Operations 1

GET /organisation Get the current organisation #

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/upguard-organisation-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 email required.

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

OpenAPI Specification

upguard-organisation-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  description: 'Access information from the CyberRisk platform programmatically using this API.


    You can find or generate an API key to access this API in your CyberRisk Account Settings.

    Please authorize all requests by setting the "Authorization" header to your api key.


    The base url for all public endpoints is https://cyber-risk.upguard.com/api/public'
  title: UpGuard CyberRisk breaches Organisation API
  version: 1.13.2
servers:
- url: https://cyber-risk.upguard.com/api/public
security:
- API key in header: []
tags:
- name: organisation
paths:
  /organisation:
    get:
      description: 'Returns the information of the organisation associated with the API key used for the request.


        Required API key permissions: `Platform` (select when creating API key in Account Settings)'
      tags:
      - organisation
      summary: Get the current organisation
      operationId: getOrganisationV1
      responses:
        '200':
          description: Information about the current organisation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetOrganisationV1RespBody'
        '422':
          description: An invalid parameter was supplied or a mandatory parameter was missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/endpointError'
        '429':
          description: Too many requests have been made to this endpoint.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/endpointError'
        '500':
          description: An internal system error occurred
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/endpointError'
components:
  schemas:
    endpointError:
      description: Error details coming from an endpoint
      type: object
      properties:
        error:
          description: A description of the error
          type: string
    CategoryScores:
      description: A collection of category scores for a vendor
      type: object
      properties:
        attackSurface:
          type: integer
          format: int64
        brandProtection:
          description: 'DEPRECATED: Use operationalRisk'
          type: integer
          format: int64
        brandReputation:
          description: 'DEPRECATED: Use operationalRisk'
          type: integer
          format: int64
        dataLeakage:
          type: integer
          format: int64
        dns:
          type: integer
          format: int64
        emailSecurity:
          type: integer
          format: int64
        encryption:
          type: integer
          format: int64
        ipDomainReputation:
          type: integer
          format: int64
        networkSecurity:
          type: integer
          format: int64
        operationalRisk:
          type: integer
          format: int64
        phishing:
          description: 'DEPRECATED: Use ipDomainReputation'
          type: integer
          format: int64
        questionnaires:
          type: integer
          format: int64
        vulnerabilityManagement:
          type: integer
          format: int64
        websiteSecurity:
          type: integer
          format: int64
    GetOrganisationV1RespBody:
      type: object
      properties:
        automatedScore:
          description: The automated score of the organisation. Omitted if no current scanning score.
          type: integer
          format: int64
        categoryScores:
          $ref: '#/components/schemas/CategoryScores'
        id:
          description: The id of the organisation
          type: integer
          format: int64
          example: 12345678
        name:
          description: The name of the organisation
          type: string
          example: UpGuard
        primary_hostname:
          description: The primary hostname of the organisation
          type: string
          example: upguard.com
  securitySchemes:
    API_key_in_header:
      type: apiKey
      in: header
      name: Authorization