Generect 1. Auth API

Login and get user info

GitHub OpenAPI

Operations 2

POST /api/auth/token/login/ Token login #
GET /api/auth/users/me/ Get User (me) #

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/generect-com:generect-com-1-auth-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.

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

OpenAPI Specification

generect-com-1-auth-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Generect 1. Auth API
  description: 'Welcome to the Generect API documentation. Here we will help you integrate and use our API.


    API base url: `https://api.generect.com` — every path below is relative to this host. Newer endpoints live under `/api/v1/...`, legacy endpoints under `/api/...`; use each path exactly as documented.

    Protocol: `HTTPS`


    # Authentication


    Get your API token from the Generect app settings and send it in the `Authorization` header with the required `Token` prefix.


    Example: `Authorization: Token xxxxxxxxx`


    # Rate limits


    There is no monthly request quota. What you can run is bounded by your account balance and by the parallel-request caps on the Limits page. Pricing depends on the operation and the number of results returned, and may increase with additional data flags. For exact pricing, see each endpoint''s Pricing section or your billing settings: https://app.generect.com/settings/billing


    # Note


    _Every endpoint must include the trailing `/`. Requests without the trailing slash may fail._'
  version: 1.0.0
  contact: {}
servers:
- url: https://api.generect.com
security:
- apiKey: []
tags:
- name: 1. Auth
  description: Login and get user info
paths:
  /api/auth/token/login/:
    post:
      tags:
      - 1. Auth
      summary: Token login
      description: Login to account and get `auth_token`
      operationId: tokenLogin
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  example: example@example.com
                password:
                  type: string
                  example: '12345678'
            examples:
              Token login:
                value:
                  email: example@example.com
                  password: '12345678'
      responses:
        '200':
          description: '200'
          headers:
            Allow:
              schema:
                type: string
                example: POST, OPTIONS
            Content-Length:
              schema:
                type: string
                example: '134'
            Cross-Origin-Opener-Policy:
              schema:
                type: string
                example: same-origin
            Date:
              schema:
                type: string
                example: Wed, 04 Dec 2024 14:43:33 GMT
            Referrer-Policy:
              schema:
                type: string
                example: same-origin
            Server:
              schema:
                type: string
                example: WSGIServer/0.2 CPython/3.11.10
            Vary:
              schema:
                type: string
                example: Accept, Cookie, Origin
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Frame-Options:
              schema:
                type: string
                example: DENY
          content:
            application/json:
              schema:
                type: object
                properties:
                  auth_token:
                    type: string
                    example: '0000011111222223333344444555556666677777'
                  email:
                    type: string
                    example: example@example.com
                  user_id:
                    type: string
                    example: 00000111-1122-2223-3333-444445555566
              examples:
                '200':
                  value:
                    auth_token: '0000011111222223333344444555556666677777'
                    email: example@example.com
                    user_id: 00000111-1122-2223-3333-444445555566
      security:
      - {}
  /api/auth/users/me/:
    get:
      tags:
      - 1. Auth
      summary: Get User (me)
      description: Retrieve the current user's credit balance and account details
      operationId: getUserMe
      responses:
        '200':
          description: '200'
          headers:
            Allow:
              schema:
                type: string
                example: GET, PUT, PATCH, DELETE, HEAD, OPTIONS
            Content-Length:
              schema:
                type: string
                example: '872'
            Cross-Origin-Opener-Policy:
              schema:
                type: string
                example: same-origin
            Date:
              schema:
                type: string
                example: Mon, 02 Dec 2024 20:45:10 GMT
            Referrer-Policy:
              schema:
                type: string
                example: same-origin
            Server:
              schema:
                type: string
                example: WSGIServer/0.2 CPython/3.11.10
            Vary:
              schema:
                type: string
                example: Accept, Origin
            X-Content-Type-Options:
              schema:
                type: string
                example: nosniff
            X-Frame-Options:
              schema:
                type: string
                example: DENY
          content:
            application/json:
              schema:
                type: object
                properties:
                  balance_companies_by_icp:
                    type: number
                    example: -101
                  balance_company_by_link:
                    type: number
                    example: 0
                  balance_email_finder:
                    type: number
                    example: 0
                  balance_email_verifier:
                    type: number
                    example: 0
                  balance_lead_by_link:
                    type: number
                    example: -3
                  balance_leads_by_icp:
                    type: number
                    example: -1719
                  balance_platform:
                    type: number
                    example: 8531
                  beta_tester:
                    type: boolean
                    example: false
                  blocked_balance_platform:
                    type: number
                    example: 0
                  consultancy_hours:
                    type: number
                    example: 3
                  count_parallel_searches:
                    type: number
                    example: 0
                  count_searches_completed_today:
                    type: number
                    example: 0
                  count_searches_in_progress_today:
                    type: number
                    example: 0
                  email:
                    type: string
                    example: admin@example.com
                  full_name:
                    type: string
                    example: ''
                  icp_flow:
                    type: object
                    properties:
                      A:
                        type: string
                        example: '1'
                      active_compaign_count_lead:
                        type: number
                        example: 1000
                      active_compaign_first_icp:
                        type: string
                        example: 'true'
                      active_compaign_first_lead:
                        type: string
                        example: 'true'
                      active_compaign_first_search:
                        type: string
                        example: 'true'
                  is_staff:
                    type: boolean
                    example: true
                  last_invoice_status:
                    type: boolean
                    example: true
                  last_password_changed:
                    type: string
                    example: '2024-10-30T13:09:31'
                  logo:
                    example: null
                  max_credits:
                    type: number
                    example: 10000
                  max_parallel_searches:
                    type: number
                    example: 5
                  max_searches_daily:
                    type: number
                    example: 20
                  prev_subscription_status:
                    example: null
                  spent_for_emails:
                    type: number
                    example: 303
                  spent_for_export:
                    type: number
                    example: 0
                  subscription:
                    type: string
                    example: Business
                  trial_available:
                    type: boolean
                    example: true
              examples:
                '200':
                  value:
                    balance_companies_by_icp: -101
                    balance_company_by_link: 0
                    balance_email_finder: 0
                    balance_email_verifier: 0
                    balance_lead_by_link: -3
                    balance_leads_by_icp: -1719
                    balance_platform: 8531
                    beta_tester: false
                    blocked_balance_platform: 0
                    consultancy_hours: 3
                    count_parallel_searches: 0
                    count_searches_completed_today: 0
                    count_searches_in_progress_today: 0
                    email: admin@example.com
                    full_name: ''
                    icp_flow:
                      A: '1'
                      active_compaign_count_lead: 1000
                      active_compaign_first_icp: 'true'
                      active_compaign_first_lead: 'true'
                      active_compaign_first_search: 'true'
                    is_staff: true
                    last_invoice_status: true
                    last_password_changed: '2024-10-30T13:09:31'
                    logo: null
                    max_credits: 10000
                    max_parallel_searches: 5
                    max_searches_daily: 20
                    prev_subscription_status: null
                    spent_for_emails: 303
                    spent_for_export: 0
                    subscription: Business
                    trial_available: true
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: Authorization
      description: 'Use the required Token prefix. Example: Authorization: Token xxxxxxxxx'