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/agentictrade-io:agentictrade-io-services-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.

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: Agentictrade Io Services API
  version: 0.7.1
  description: 'Operations tagged services across 2 of this provider''s published API definitions: agentictrade-io-openapi.json, agentictrade-io.json. Each path carries the servers of the definition it was published in.'
tags:
- name: Services
paths:
  /api/v1/services:
    post:
      tags:
      - Services
      summary: Register Service
      description: Register a new service on the marketplace. Requires API key.
      operationId: register_service_api_v1_services_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterServiceRequest'
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    get:
      tags:
      - Services
      summary: List Services
      description: List or search services. No auth required.
      operationId: list_services_api_v1_services_get
      parameters:
      - name: query
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Query
      - name: category
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
      - name: status
        in: query
        required: false
        schema:
          type: string
          default: active
          title: Status
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/services/{service_id}:
    get:
      tags:
      - Services
      summary: Get Service
      description: Get service details. No auth required.
      operationId: get_service_api_v1_services__service_id__get
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    patch:
      tags:
      - Services
      summary: Update Service
      description: Update a service (owner only). Requires API key.
      operationId: update_service_api_v1_services__service_id__patch
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateServiceRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    delete:
      tags:
      - Services
      summary: Delete Service
      description: Remove a service (soft delete, owner only). Requires API key.
      operationId: delete_service_api_v1_services__service_id__delete
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/providers:
    get:
      tags:
      - Services
      summary: List Providers
      description: 'List all providers on the marketplace with aggregate stats. No auth required.


        Privacy: returns only public-safe fields (id, service counts, avg quality).

        Owner email and other PII are not exposed.


        Query params:

        limit: page size (default 50, max 100)

        offset: pagination offset

        min_services: filter providers with >= N active services (default 1, hide empty)'
      operationId: list_providers_api_v1_providers_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          default: 50
          title: Limit
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          default: 0
          title: Offset
      - name: min_services
        in: query
        required: false
        schema:
          type: integer
          default: 1
          title: Min Services
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/services/{service_id}/proxy-secret:
    get:
      tags:
      - Services
      summary: Get Proxy Secret
      description: 'Get the proxy secret for a service (owner only).


        Providers use the proxy_secret to verify X-ACF-Signature headers

        from the marketplace proxy. The secret is NOT returned on public endpoints.'
      operationId: get_proxy_secret_api_v1_services__service_id__proxy_secret_get
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Services
      summary: Rotate Proxy Secret
      description: 'Rotate the proxy secret for a service (owner only).


        Returns the NEW secret. The old secret is invalidated immediately.

        Providers use the secret to verify X-ACF-Signature headers from the marketplace proxy.'
      operationId: rotate_proxy_secret_api_v1_services__service_id__proxy_secret_post
      parameters:
      - name: service_id
        in: path
        required: true
        schema:
          type: string
          title: Service Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/provider-contact:
    get:
      tags:
      - Services
      summary: Get Provider Contact Info
      description: Get current provider notification contact settings.
      operationId: get_provider_contact_info_api_v1_provider_contact_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
    put:
      tags:
      - Services
      summary: Set Provider Contact
      description: 'Set or update provider notification contact for quality alerts.


        Email is required. Locale auto-detects from Accept-Language if not provided.

        Supported locales: en, zh-tw, ko, ja, fr, de, ru, es, pt.'
      operationId: set_provider_contact_api_v1_provider_contact_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ProviderContactRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /api/v1/founding-sellers:
    get:
      tags:
      - Services
      summary: List Founding Sellers
      description: List all founding sellers (first 50 providers). No auth required.
      operationId: list_founding_sellers_api_v1_founding_sellers_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
  /api/v1/founding-sellers/{provider_id}:
    get:
      tags:
      - Services
      summary: Get Founding Seller
      description: Check if a provider is a founding seller. No auth required.
      operationId: get_founding_seller_api_v1_founding_sellers__provider_id__get
      parameters:
      - name: provider_id
        in: path
        required: true
        schema:
          type: string
          title: Provider Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ProviderContactRequest:
      properties:
        email:
          type: string
          title: Email
        preferred_locale:
          anyOf:
          - type: string
          - type: 'null'
          title: Preferred Locale
      type: object
      required:
      - email
      title: ProviderContactRequest
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    RegisterServiceRequest:
      properties:
        name:
          type: string
          title: Name
        description:
          type: string
          title: Description
          default: ''
        endpoint:
          type: string
          title: Endpoint
        price_per_call:
          type: string
          title: Price Per Call
        category:
          type: string
          title: Category
          default: ''
        tags:
          items:
            type: string
          type: array
          title: Tags
          default: []
        payment_method:
          type: string
          title: Payment Method
          default: x402
        free_tier_calls:
          type: integer
          title: Free Tier Calls
          default: 0
      type: object
      required:
      - name
      - endpoint
      - price_per_call
      title: RegisterServiceRequest
    UpdateServiceRequest:
      properties:
        name:
          anyOf:
          - type: string
          - type: 'null'
          title: Name
        description:
          anyOf:
          - type: string
          - type: 'null'
          title: Description
        endpoint:
          anyOf:
          - type: string
          - type: 'null'
          title: Endpoint
        price_per_call:
          anyOf:
          - type: string
          - type: 'null'
          title: Price Per Call
        status:
          anyOf:
          - type: string
          - type: 'null'
          title: Status
        category:
          anyOf:
          - type: string
          - type: 'null'
          title: Category
        tags:
          anyOf:
          - items:
              type: string
            type: array
          - type: 'null'
          title: Tags
      type: object
      title: UpdateServiceRequest
x-refined-from:
- agentictrade-io-openapi.json
- agentictrade-io.json