Brellium Audits API

The Audits API from Brellium — 2 operation(s) for audits.

Operations 2

POST /audits List audits based on filter criteria
GET /audits/{audit_id} Get information about a specific audit

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/brellium-audits-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

brellium-audits-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  version: 1.0.0
  title: Brellium Audits API
  description: API for base Brellium functionality.
  termsOfService: https://brellium.com/terms
  contact:
    name: Brellium Team
    email: support@brellium.com
    url: http://brellium.com
servers:
- url: https://api.brellium.com/v1
tags:
- name: Audits
paths:
  /audits:
    post:
      summary: List audits based on filter criteria
      requestBody:
        description: Filter to retrieve audits with.
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuditFilter'
      responses:
        '200':
          description: List of audits. The structure of the returned audits depends on the 'verbose', 'includeDisplayInfo', and 'includePeople' flags in the request. If 'verbose' is true, full audit details are returned (Audit schema). If 'verbose' is false, a reduced audit object is returned (AuditInfo schema). If 'includeDisplayInfo' and 'includePeople' are true, the returned audits will include display info and people respectively. Both 'verbose' and one of the other two flags can be used together.
          content:
            application/json:
              schema:
                oneOf:
                - description: Array of full audits with display info and/or people.
                  type: array
                  items:
                    $ref: '#/components/schemas/AuditWithDisplayAndPeople'
                - description: Array of full audits.
                  type: array
                  items:
                    $ref: '#/components/schemas/Audit'
                - description: Array of reduced audit objects.
                  type: array
                  items:
                    $ref: '#/components/schemas/AuditInfo'
      security:
      - bearerAuth: []
      tags:
      - Audits
  /audits/{audit_id}:
    get:
      summary: Get information about a specific audit
      parameters:
      - name: audit_id
        in: path
        required: true
        schema:
          type: string
          description: Audit id.
      - name: includeDisplayInfo
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
        description: Include display info in the response.
      - name: includePeople
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
        description: Include people information in the response.
      - name: includeQuestionIds
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
        description: Include question ids in the response.
      - name: includeLastReviewed
        in: query
        required: false
        schema:
          type: string
          enum:
          - 'true'
          - 'false'
        description: Include last reviewed timestamp in the response - N/A if never reviewed.
      responses:
        '200':
          description: Audit information, optionally including responses, display info, and people.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AuditWithDisplayAndPeople'
      security:
      - bearerAuth: []
      tags:
      - Audits
components:
  schemas:
    AuditInfo:
      type: object
      properties:
        audit_id:
          type: string
          description: Audit id.
        status:
          type: string
          enum:
          - todo
          - processing
          - in_progress
          - error
          - complete
          description: Current status of the audit.
        timestamp:
          type: string
          format: date-time
          description: When the audit was created.
    AuditWithDisplayAndPeople:
      type: object
      properties:
        audit_id:
          type: string
          description: Audit id.
        status:
          type: string
          enum:
          - todo
          - in_progress
          - error
          - complete
          description: The status of the audit.
        score:
          type: number
          format: float
          description: The score of the audit.
        flags:
          type: array
          items:
            type: string
          description: The flags on the audit.
        reviewed_by:
          type: string
          description: The email of the reviewer.
        set_id:
          type: string
          description: Id of question set used for the audit.
        timestamp:
          type: string
          format: date-time
          description: When the audit was created.
        responses:
          type: array
          items:
            type: object
            properties:
              response_id:
                type: string
                description: Response id.
              query:
                type: string
                description: The criteria question.
              answer:
                type: string
                enum:
                - 'Yes'
                - N/A
                - 'No'
                description: The answer to the question.
              context:
                type: string
                description: The context for the answer.
            required:
            - query
            - answer
            - context
          description: The responses the audit is comprised of.
        display_info:
          type: array
          items:
            type: object
            description: Additional display information for the audit.
            properties:
              key:
                type: string
                description: Internal key for the display info item.
              order:
                type: integer
                description: Order in which the item should be displayed.
              title:
                type: string
                description: Title of the display info item.
              value:
                type: string
                description: Value of the display info item.
              format:
                type: string
                description: Format of the value (e.g., 'text').
              filter_type:
                type: string
                description: Type of filter to be applied (e.g., 'search').
            required:
            - key
            - order
            - title
            - value
            - format
            - filter_type
            example:
              key: episode_id
              order: 1
              title: Episode ID
              value: '12341234'
              format: text
              filter_type: search
        people:
          type: array
          items:
            type: object
            properties:
              key:
                type: string
                description: Internal key for the display info item.
              order:
                type: integer
                description: Order in which the person should be displayed.
              title:
                type: string
                description: Title or role of the person.
              value:
                type: string
                description: Name or identifier of the person.
              format:
                type: string
                description: Format of the value (e.g., 'text').
              filter_type:
                type: string
                description: Type of filter to be applied (e.g., 'people').
            required:
            - key
            - order
            - title
            - value
            - format
            - filter_type
            example:
              key: RN
              order: 1
              title: RN
              value: John Doe RN
              format: text
              filter_type: people
          description: Information about people associated with the audit.
        documents:
          type: array
          items:
            type: string
            description: Document id.
          description: The documents in the audit.
        people_emails:
          type: array
          items:
            type: object
            properties:
              title:
                type: string
                description: The person's title or role.
              name:
                type: string
                description: The person's name.
              email:
                type: string
                description: The person's email, if found.
          description: The emails of the people in the audit.
    Audit:
      type: object
      properties:
        audit_id:
          type: string
          description: Audit id.
        status:
          type: string
          enum:
          - todo
          - in_progress
          - error
          - complete
          description: The status of the audit.
        score:
          type: number
          format: float
          description: The score of the audit.
        flags:
          type: array
          items:
            type: string
          description: The flags on the audit.
        reviewed_by:
          type: string
          description: The email of the reviewer.
        set_id:
          type: string
          description: Id of question set used for the audit.
        timestamp:
          type: string
          format: date-time
          description: When the audit was created.
        responses:
          type: array
          items:
            type: object
            properties:
              response_id:
                type: string
                description: Response id.
              query:
                type: string
                description: The criteria question.
              answer:
                type: string
                enum:
                - 'Yes'
                - N/A
                - 'No'
                description: The answer to the question.
              context:
                type: string
                description: The context for the answer.
            required:
            - query
            - answer
            - context
          description: The responses the audit is comprised of.
    AuditFilter:
      type: object
      properties:
        verbose:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: Controls the level of detail in the response.
        status:
          type:
          - array
          - 'null'
          items:
            type: string
            enum:
            - todo
            - processing
            - in_progress
            - error
            - complete
          description: Audit statuses to include.
        set_id:
          type: string
          description: Question set id.
        documents:
          type:
          - array
          - 'null'
          items:
            type: string
          description: Document ids that the audits were made for.
        sessionStartDate:
          type:
          - string
          - 'null'
          format: date-time
          description: Start date of the session in ISO format.
        sessionEndDate:
          type:
          - string
          - 'null'
          format: date-time
          description: End date of the session in ISO format.
        auditStartDate:
          type:
          - string
          - 'null'
          format: date-time
          description: Start date of the audit in ISO format.
        auditEndDate:
          type:
          - string
          - 'null'
          format: date-time
          description: End date of the audit in ISO format.
        scoreLowerBound:
          type:
          - number
          - 'null'
          format: float
          minimum: 0
          maximum: 100
          description: Lower bound for the audit score.
        scoreUpperBound:
          type:
          - number
          - 'null'
          format: float
          minimum: 0
          maximum: 100
          description: Upper bound for the audit score.
        lastUpdatedStartDate:
          type:
          - string
          - 'null'
          format: date-time
          description: Start date of the audit's latest update in ISO format.
        lastUpdatedEndDate:
          type:
          - string
          - 'null'
          format: date-time
          description: End date of the audit's latest update in ISO format.
        page:
          type:
          - integer
          - 'null'
          minimum: 1
          description: Page number.
        pageSize:
          type:
          - integer
          - 'null'
          minimum: 1
          maximum: 1000
          description: Number of audits per page.
        includeDisplayInfo:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: Include display info.
        includePeople:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: Include people.
        includeTestAudits:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: If true only test audits are returned, if false or null only non-test audits are returned.
        includeQuestionIds:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: Include question ids in the response.
        includeLastReviewed:
          type:
          - string
          - 'null'
          enum:
          - 'true'
          - 'false'
          description: Include last reviewed timestamp in the response - N/A if never reviewed.
        flags:
          type:
          - array
          - 'null'
          items:
            type: string
          description: Flags to filter by.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT