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/esyurl-fyi:esyurl-fyi-me-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: Esyurl Fyi Me API
  version: 2.0.0
  contact:
    name: esyURL
    email: contact@esyurl.fyi
    url: https://esyurl.fyi/about/contact
  x-guidance: 'Get an API key first: follow /auth.md (agents sign themselves up, no human needed). Then POST /v1/links with {"targetUrl": "...", "slug": "..."} for a short link and GET /v1/links/{id}/qr for its QR code. PUT /v1/domain {"domain": "go.example.com"} sets a custom domain; for self-signed-up tenants it answers 402 and is paid with x402 (USDC), once per domain. The full guide is /llms.txt.'
  description: 'Operations tagged Me across 2 of this provider''s published API definitions: openapi.json, esyurl-fyi-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://esyurl.fyi
security:
- bearerAuth: []
- apiKeyHeader: []
tags:
- name: Me
paths:
  /v1/me:
    get:
      summary: The calling principal and its tenant
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Me'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
          headers:
            WWW-Authenticate:
              schema:
                type: string
              description: 'Bearer resource_metadata="{baseUrl}/.well-known/oauth-protected-resource" (RFC 9728; how to sign up: /auth.md)'
      tags:
      - Me
      operationId: getV1Me
      x-operation-id-source: derived
    servers:
    - url: https://esyurl.fyi
components:
  schemas:
    Error:
      type: object
      required:
      - error
      properties:
        error:
          type: object
          required:
          - code
          - message
          properties:
            code:
              type: string
              enum:
              - bad_request
              - validation_error
              - unauthorized
              - forbidden
              - not_found
              - conflict
              - gone
              - payment_required
              - quota_exceeded
              - rate_limited
              - internal_error
              - payments_not_configured
              - service_unavailable
            message:
              type: string
            details: {}
    Me:
      type: object
      properties:
        principal:
          type: object
          properties:
            tenantId:
              type: string
            subject:
              type: string
            method:
              type: string
              enum:
              - api_key
              - jwt
            scopes:
              type: array
              items:
                type: string
                enum:
                - links:read
                - links:write
        tenant:
          type: object
          properties:
            tenantId:
              type: string
            name:
              type: string
            status:
              type: string
              enum:
              - active
              - suspended
            createdAt:
              type: string
              format: date-time
            origin:
              type: string
              enum:
              - operator
              - agent_signup
              description: Absent means operator. agent_signup tenants pay for custom domains
            linkLimit:
              type: integer
              description: Link quota; absent = unlimited
            linkCount:
              type: integer
              description: Links held, for tenants with a linkLimit
            ownerEmail:
              type: string
              description: Set when a human claimed a self-signed-up tenant
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key `esy_{keyId}_{secret}`, from an operator or from agent self-sign-up (/auth.md)
    apiKeyHeader:
      type: apiKey
      in: header
      name: x-api-key
x-refined-from:
- openapi.json
- esyurl-fyi-openapi.json