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/alphabazaar-ai:alphabazaar-ai-notifications-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Alphabazaar Ai Notifications API
  version: 2.2.0-socketio
  contact:
    name: Alpha Bazaar
    url: https://alphabazaar.ai/
    email: support@alphabazaar.ai
  license:
    name: Proprietary
  termsOfService: https://www.alphabazaar.ai/legal/terms
  description: 'Operations tagged Notifications across 2 of this provider''s published API definitions: alphabazaar-ai-openapi.yml, openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://alpha-bazaar-signal-server.onrender.com
  description: Production
- url: https://dev-alpha-bazaar-signal-server.onrender.com
  description: Staging
security:
- HTTPBearer: []
tags:
- name: Notifications
  description: Push notifications and alert preferences
paths:
  /api/alerts:
    get:
      tags:
      - Notifications
      summary: Api Get Alerts
      description: Get alerts for the authenticated user
      operationId: api_get_alerts_api_alerts_get
      security:
      - HTTPBearer: []
      parameters:
      - name: page
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          description: Page number (1-indexed)
          default: 1
          title: Page
        description: Page number (1-indexed)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Results per page
          default: 50
          title: Limit
        description: Results per page
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Alert category filter
          title: Category
        description: Alert category filter
      - name: alert_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Alert type filter
          title: Alert Type
        description: Alert type filter
      - name: read_status
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Read status filter
          title: Read Status
        description: Read status filter
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AlertsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/alerts/{alert_id}/read:
    post:
      tags:
      - Notifications
      summary: Api Mark Alert As Read
      description: Mark a specific alert as read
      operationId: api_mark_alert_as_read_api_alerts__alert_id__read_post
      security:
      - HTTPBearer: []
      parameters:
      - name: alert_id
        in: path
        required: true
        schema:
          type: string
          title: Alert Id
        description: Alert UUID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/alerts/read-all:
    post:
      tags:
      - Notifications
      summary: Api Mark All Alerts As Read
      description: Mark all alerts as read for the authenticated user
      operationId: api_mark_all_alerts_as_read_api_alerts_read_all_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/alerts/{alert_id}:
    delete:
      tags:
      - Notifications
      summary: Api Delete Alert
      description: Delete a specific alert
      operationId: api_delete_alert_api_alerts__alert_id__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: alert_id
        in: path
        required: true
        schema:
          type: string
          title: Alert Id
        description: Alert UUID
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/alerts/unread-count:
    get:
      tags:
      - Notifications
      summary: Api Get Unread Count
      description: Get unread alert count by category
      operationId: api_get_unread_count_api_alerts_unread_count_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnreadCountResponse'
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notification-preferences:
    get:
      tags:
      - Notifications
      summary: Api Get Notification Preferences
      description: Get notification preferences for the authenticated user
      operationId: api_get_notification_preferences_api_notification_preferences_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationPreferencesResponse'
      security:
      - HTTPBearer: []
    put:
      tags:
      - Notifications
      summary: Api Update Notification Preferences
      description: Update notification preferences for the authenticated user
      operationId: api_update_notification_preferences_api_notification_preferences_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePreferencesRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notification-preferences/{preference_name}:
    patch:
      tags:
      - Notifications
      summary: Api Update Single Notification Preference
      description: Update a single notification preference
      operationId: api_update_single_notification_preference_api_notification_preferences__preference_name__patch
      security:
      - HTTPBearer: []
      parameters:
      - name: preference_name
        in: path
        required: true
        schema:
          type: string
          title: Preference Name
        description: Notification preference name
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSinglePreferenceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notifications/preferences:
    get:
      tags:
      - Notifications
      summary: Api Get Notification Preferences Mobile
      description: Get notification preferences (mobile app path)
      operationId: api_get_notification_preferences_mobile_api_notifications_preferences_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotificationPreferencesResponse'
      security:
      - HTTPBearer: []
    put:
      tags:
      - Notifications
      summary: Api Update Notification Preferences Mobile
      description: Update notification preferences (mobile app path)
      operationId: api_update_notification_preferences_mobile_api_notifications_preferences_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePreferencesRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notifications/preferences/{preference_name}:
    patch:
      tags:
      - Notifications
      summary: Api Update Single Notification Preference Mobile
      description: Update a single notification preference (mobile app path)
      operationId: api_update_single_notification_preference_mobile_api_notifications_preferences__preference_name__patch
      security:
      - HTTPBearer: []
      parameters:
      - name: preference_name
        in: path
        required: true
        schema:
          type: string
          title: Preference Name
        description: Notification preference name
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateSinglePreferenceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notifications/register-token:
    post:
      tags:
      - Notifications
      summary: Register Push Token
      description: Register a push notification token for the user
      operationId: register_push_token_api_notifications_register_token_post
      requestBody:
        content:
          application/json:
            schema:
              additionalProperties: true
              type: object
              title: Token Data
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notifications/unregister-token/{token}:
    delete:
      tags:
      - Notifications
      summary: Unregister Push Token
      description: Unregister a push notification token
      operationId: unregister_push_token_api_notifications_unregister_token__token__delete
      security:
      - HTTPBearer: []
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          description: Password reset token or push notification token
          title: Token
        description: Password reset token or push notification token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
  /api/notifications/test-push:
    post:
      tags:
      - Notifications
      summary: Test Push Notification
      description: Send a test push notification to the user
      operationId: test_push_notification_api_notifications_test_push_post
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      security:
      - HTTPBearer: []
    servers:
    - url: https://alpha-bazaar-signal-server.onrender.com
      description: Production
    - url: https://dev-alpha-bazaar-signal-server.onrender.com
      description: Staging
components:
  schemas:
    UpdatePreferencesRequest:
      properties:
        preferences:
          additionalProperties:
            type: boolean
          type: object
          title: Preferences
      type: object
      required:
      - preferences
      title: UpdatePreferencesRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    NotificationPreferencesResponse:
      properties:
        user_id:
          type: string
          title: User Id
        is_publisher:
          type: boolean
          title: Is Publisher
        preferences:
          additionalProperties:
            type: boolean
          type: object
          title: Preferences
        limits:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Limits
      type: object
      required:
      - user_id
      - is_publisher
      - preferences
      title: NotificationPreferencesResponse
    UnreadCountResponse:
      properties:
        total:
          type: integer
          title: Total
        by_category:
          additionalProperties:
            type: integer
          type: object
          title: By Category
      type: object
      required:
      - total
      - by_category
      title: UnreadCountResponse
    AlertResponse:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        alert_type:
          type: string
          title: Alert Type
        title:
          type: string
          title: Title
        message:
          type: string
          title: Message
        data:
          anyOf:
          - additionalProperties: true
            type: object
          - type: 'null'
          title: Data
        read:
          type: boolean
          title: Read
        created_at:
          type: string
          title: Created At
        expires_at:
          anyOf:
          - type: string
          - type: 'null'
          title: Expires At
      type: object
      required:
      - id
      - user_id
      - alert_type
      - title
      - message
      - read
      - created_at
      title: AlertResponse
    AlertsResponse:
      properties:
        alerts:
          items:
            $ref: '#/components/schemas/AlertResponse'
          type: array
          title: Alerts
        total:
          type: integer
          title: Total
        page:
          type: integer
          title: Page
        limit:
          type: integer
          title: Limit
        total_pages:
          type: integer
          title: Total Pages
      type: object
      required:
      - alerts
      - total
      - page
      - limit
      - total_pages
      title: AlertsResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    UpdateSinglePreferenceRequest:
      properties:
        value:
          type: boolean
          title: Value
      type: object
      required:
      - value
      title: UpdateSinglePreferenceRequest
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
externalDocs:
  description: Agent integration guide and full API docs
  url: https://www.alphabazaar.ai/llms-full.txt
x-refined-from:
- alphabazaar-ai-openapi.yml
- openapi.json