Aveco Utilities API

The Utilities API from Aveco — 19 operation(s) for utilities.

Operations 19

GET /utilities Utilities Index #
POST /utilities/dedup Utilities Dedup #
POST /api/utilities/dedup Utilities Dedup Api #
GET /utilities/download/{token} Utilities Download #
GET /utilities/sessions Utilities Sessions #
GET /api/utilities/sessions/meta Utilities Sessions Meta #
POST /utilities/sessions/credentials Utilities Sessions Credentials #
POST /utilities/proxy/test Utilities Proxy Test #
POST /utilities/sessions/send-code Utilities Sessions Send Code #
POST /utilities/sessions/confirm Utilities Sessions Confirm #
POST /utilities/sessions/upload Utilities Sessions Upload #
GET /utilities/phone-check Utilities Phone Check #
GET /api/utilities/phone-check/meta Utilities Phone Check Meta #
POST /utilities/phone-check/credentials Utilities Phone Check Credentials #
POST /utilities/phone-check/sessions Utilities Phone Check Sessions #
POST /utilities/phone-check/sessions/{session_id}/delete Utilities Phone Check Sessions Delete #
POST /utilities/phone-check/start Utilities Phone Check Start #
GET /utilities/phone-check/download/{run_id}/numbers Utilities Phone Check Download Numbers #
GET /utilities/phone-check/download/{run_id}/users Utilities Phone Check Download Users #

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/aveco-app:aveco-app-utilities-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

aveco-app-utilities-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Aveco Utilities API
  version: 0.1.0
tags:
- name: Utilities
paths:
  /utilities:
    get:
      summary: Utilities Index
      operationId: utilities_index_utilities_get
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
      tags:
      - Utilities
  /utilities/dedup:
    post:
      summary: Utilities Dedup
      operationId: utilities_dedup_utilities_dedup_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_dedup_utilities_dedup_post'
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /api/utilities/dedup:
    post:
      summary: Utilities Dedup Api
      operationId: utilities_dedup_api_api_utilities_dedup_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_dedup_api_api_utilities_dedup_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/download/{token}:
    get:
      summary: Utilities Download
      operationId: utilities_download_utilities_download__token__get
      parameters:
      - name: token
        in: path
        required: true
        schema:
          type: string
          title: Token
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/sessions:
    get:
      summary: Utilities Sessions
      operationId: utilities_sessions_utilities_sessions_get
      parameters:
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /api/utilities/sessions/meta:
    get:
      summary: Utilities Sessions Meta
      operationId: utilities_sessions_meta_api_utilities_sessions_meta_get
      parameters:
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/sessions/credentials:
    post:
      summary: Utilities Sessions Credentials
      operationId: utilities_sessions_credentials_utilities_sessions_credentials_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_sessions_credentials_utilities_sessions_credentials_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/proxy/test:
    post:
      summary: Utilities Proxy Test
      description: 'Lets the account-connect wizard''s proxy section verify a proxy

        actually reaches Telegram before the user spends a phone-code attempt

        on it.'
      operationId: utilities_proxy_test_utilities_proxy_test_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_proxy_test_utilities_proxy_test_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/sessions/send-code:
    post:
      summary: Utilities Sessions Send Code
      description: 'Shared by two callers: the Outreach account-connect wizard

        (TelegramConnectWizard, no longer offers a task picker — always

        submits "outreach") and the Parsing > Sessions page

        (utilities-sessions-page.tsx), which still lets the user pick a task

        bucket (leadgen/data/tools) for parsing-purpose sessions.


        `relogin_session_id`, when set, targets an existing SessionFile (e.g.

        one flagged "Session not authorized") instead of creating a new one —

        the account-connect wizard''s "re-login" action for a broken account.

        Re-uses that session''s exact file path/proxy and skips the

        name-collision check, so `confirm` below finds the same SessionFile row

        and `upsert_outreach_account` refreshes the same TelegramOutreachAccount

        in place rather than the user having to delete+recreate the account.


        `mode="register"` is the third account-connect path: instead of logging

        into an existing Telegram account, the operator is creating a brand-new

        one (a physical SIM phone number that''s never touched Telegram before).

        Telegram requires a proxy for this — an unproxied bulk-registration

        pattern is one of the clearest signals their anti-abuse systems look

        for — so it''s enforced here as a hard error, unlike login where a proxy

        stays optional.'
      operationId: utilities_sessions_send_code_utilities_sessions_send_code_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_sessions_send_code_utilities_sessions_send_code_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/sessions/confirm:
    post:
      summary: Utilities Sessions Confirm
      operationId: utilities_sessions_confirm_utilities_sessions_confirm_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_sessions_confirm_utilities_sessions_confirm_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/sessions/upload:
    post:
      summary: Utilities Sessions Upload
      description: 'Second account-connect path, alongside the phone+code wizard: attach

        an already-authorized .session file directly, so a customer who already

        has a valid session for the account doesn''t have to re-login by phone.'
      operationId: utilities_sessions_upload_utilities_sessions_upload_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_utilities_sessions_upload_utilities_sessions_upload_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check:
    get:
      summary: Utilities Phone Check
      operationId: utilities_phone_check_utilities_phone_check_get
      parameters:
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      responses:
        '200':
          description: Successful Response
          content:
            text/html:
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /api/utilities/phone-check/meta:
    get:
      summary: Utilities Phone Check Meta
      operationId: utilities_phone_check_meta_api_utilities_phone_check_meta_get
      parameters:
      - name: error
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Error
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/credentials:
    post:
      summary: Utilities Phone Check Credentials
      operationId: utilities_phone_check_credentials_utilities_phone_check_credentials_post
      requestBody:
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/Body_utilities_phone_check_credentials_utilities_phone_check_credentials_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/sessions:
    post:
      summary: Utilities Phone Check Sessions
      operationId: utilities_phone_check_sessions_utilities_phone_check_sessions_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_utilities_phone_check_sessions_utilities_phone_check_sessions_post'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/sessions/{session_id}/delete:
    post:
      summary: Utilities Phone Check Sessions Delete
      operationId: utilities_phone_check_sessions_delete_utilities_phone_check_sessions__session_id__delete_post
      parameters:
      - name: session_id
        in: path
        required: true
        schema:
          type: integer
          title: Session Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/start:
    post:
      summary: Utilities Phone Check Start
      operationId: utilities_phone_check_start_utilities_phone_check_start_post
      requestBody:
        content:
          multipart/form-data:
            schema:
              $ref: '#/components/schemas/Body_utilities_phone_check_start_utilities_phone_check_start_post'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/download/{run_id}/numbers:
    get:
      summary: Utilities Phone Check Download Numbers
      operationId: utilities_phone_check_download_numbers_utilities_phone_check_download__run_id__numbers_get
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: integer
          title: Run Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
  /utilities/phone-check/download/{run_id}/users:
    get:
      summary: Utilities Phone Check Download Users
      operationId: utilities_phone_check_download_users_utilities_phone_check_download__run_id__users_get
      parameters:
      - name: run_id
        in: path
        required: true
        schema:
          type: integer
          title: Run Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      tags:
      - Utilities
components:
  schemas:
    Body_utilities_sessions_credentials_utilities_sessions_credentials_post:
      properties:
        api_id:
          type: string
          title: Api Id
        api_hash:
          type: string
          title: Api Hash
        redirect_tab:
          type: string
          title: Redirect Tab
          default: ''
      type: object
      required:
      - api_id
      - api_hash
      title: Body_utilities_sessions_credentials_utilities_sessions_credentials_post
    Body_utilities_phone_check_start_utilities_phone_check_start_post:
      properties:
        raw_numbers:
          type: string
          title: Raw Numbers
          default: ''
        file:
          anyOf:
          - type: string
            contentMediaType: application/octet-stream
          - type: 'null'
          title: File
      type: object
      title: Body_utilities_phone_check_start_utilities_phone_check_start_post
    Body_utilities_phone_check_sessions_utilities_phone_check_sessions_post:
      properties:
        files:
          items:
            type: string
            contentMediaType: application/octet-stream
          type: array
          title: Files
      type: object
      required:
      - files
      title: Body_utilities_phone_check_sessions_utilities_phone_check_sessions_post
    Body_utilities_sessions_upload_utilities_sessions_upload_post:
      properties:
        file:
          type: string
          contentMediaType: application/octet-stream
          title: File
        proxy_id:
          type: string
          title: Proxy Id
          default: ''
        proxy_type:
          type: string
          title: Proxy Type
          default: ''
        proxy_host:
          type: string
          title: Proxy Host
          default: ''
        proxy_port:
          type: string
          title: Proxy Port
          default: ''
        proxy_username:
          type: string
          title: Proxy Username
          default: ''
        proxy_password:
          type: string
          title: Proxy Password
          default: ''
        import_history:
          type: boolean
          title: Import History
          default: false
        import_period_days:
          type: string
          title: Import Period Days
          default: ''
      type: object
      required:
      - file
      title: Body_utilities_sessions_upload_utilities_sessions_upload_post
    Body_utilities_dedup_api_api_utilities_dedup_post:
      properties:
        raw_text:
          type: string
          title: Raw Text
          default: ''
      type: object
      title: Body_utilities_dedup_api_api_utilities_dedup_post
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    Body_utilities_dedup_utilities_dedup_post:
      properties:
        raw_text:
          type: string
          title: Raw Text
          default: ''
      type: object
      title: Body_utilities_dedup_utilities_dedup_post
    Body_utilities_proxy_test_utilities_proxy_test_post:
      properties:
        proxy_type:
          type: string
          title: Proxy Type
          default: socks5
        proxy_host:
          type: string
          title: Proxy Host
        proxy_port:
          type: string
          title: Proxy Port
        proxy_username:
          type: string
          title: Proxy Username
          default: ''
        proxy_password:
          type: string
          title: Proxy Password
          default: ''
      type: object
      required:
      - proxy_host
      - proxy_port
      title: Body_utilities_proxy_test_utilities_proxy_test_post
    Body_utilities_sessions_send_code_utilities_sessions_send_code_post:
      properties:
        phone:
          type: string
          title: Phone
        session_name:
          type: string
          title: Session Name
          default: ''
        task_key:
          type: string
          title: Task Key
          default: outreach
        proxy_id:
          type: string
          title: Proxy Id
          default: ''
        proxy_type:
          type: string
          title: Proxy Type
          default: ''
        proxy_host:
          type: string
          title: Proxy Host
          default: ''
        proxy_port:
          type: string
          title: Proxy Port
          default: ''
        proxy_username:
          type: string
          title: Proxy Username
          default: ''
        proxy_password:
          type: string
          title: Proxy Password
          default: ''
        proxy_country:
          type: string
          title: Proxy Country
          default: ''
        relogin_session_id:
          type: string
          title: Relogin Session Id
          default: ''
        mode:
          type: string
          title: Mode
          default: login
        first_name:
          type: string
          title: First Name
          default: ''
        last_name:
          type: string
          title: Last Name
          default: ''
      type: object
      required:
      - phone
      title: Body_utilities_sessions_send_code_utilities_sessions_send_code_post
    Body_utilities_sessions_confirm_utilities_sessions_confirm_post:
      properties:
        draft_id:
          type: integer
          title: Draft Id
        code:
          type: string
          title: Code
          default: ''
        password:
          type: string
          title: Password
          default: ''
        import_history:
          type: boolean
          title: Import History
          default: false
        import_period_days:
          type: string
          title: Import Period Days
          default: ''
      type: object
      required:
      - draft_id
      title: Body_utilities_sessions_confirm_utilities_sessions_confirm_post
    Body_utilities_phone_check_credentials_utilities_phone_check_credentials_post:
      properties:
        api_id:
          type: string
          title: Api Id
        api_hash:
          type: string
          title: Api Hash
      type: object
      required:
      - api_id
      - api_hash
      title: Body_utilities_phone_check_credentials_utilities_phone_check_credentials_post
    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